|
|
@@ -0,0 +1,246 @@
|
|
|
+// BSD 3-Clause License
|
|
|
+//
|
|
|
+// Copyright (c) 2019, Guillaume Ballet
|
|
|
+// All rights reserved.
|
|
|
+//
|
|
|
+// Redistribution and use in source and binary forms, with or without
|
|
|
+// modification, are permitted provided that the following conditions are met:
|
|
|
+//
|
|
|
+// * Redistributions of source code must retain the above copyright notice, this
|
|
|
+// list of conditions and the following disclaimer.
|
|
|
+//
|
|
|
+// * Redistributions in binary form must reproduce the above copyright notice,
|
|
|
+// this list of conditions and the following disclaimer in the documentation
|
|
|
+// and/or other materials provided with the distribution.
|
|
|
+//
|
|
|
+// * Neither the name of the copyright holder nor the names of its
|
|
|
+// contributors may be used to endorse or promote products derived from
|
|
|
+// this software without specific prior written permission.
|
|
|
+//
|
|
|
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
|
+// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
+// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
+// DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
|
+// FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
+// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
|
+// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
|
+// CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
|
+// OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
+
|
|
|
+package pcsc
|
|
|
+
|
|
|
+import "fmt"
|
|
|
+
|
|
|
+type ErrorCode uint32
|
|
|
+
|
|
|
+const (
|
|
|
+ SCardSuccess ErrorCode = 0x00000000 /* No error was encountered. */
|
|
|
+ ErrSCardInternal = 0x80100001 /* An internal consistency check failed. */
|
|
|
+ ErrSCardCancelled = 0x80100002 /* The action was cancelled by an SCardCancel request. */
|
|
|
+ ErrSCardInvalidHandle = 0x80100003 /* The supplied handle was invalid. */
|
|
|
+ ErrSCardInvalidParameter = 0x80100004 /* One or more of the supplied parameters could not be properly interpreted. */
|
|
|
+ ErrSCardInvalidTarget = 0x80100005 /* Registry startup information is missing or invalid. */
|
|
|
+ ErrSCardNoMemory = 0x80100006 /* Not enough memory available to complete this command. */
|
|
|
+ ErrSCardWaitedTooLong = 0x80100007 /* An internal consistency timer has expired. */
|
|
|
+ ErrSCardInsufficientBuffer = 0x80100008 /* The data buffer to receive returned data is too small for the returned data. */
|
|
|
+ ErrScardUnknownReader = 0x80100009 /* The specified reader name is not recognized. */
|
|
|
+ ErrSCardTimeout = 0x8010000A /* The user-specified timeout value has expired. */
|
|
|
+ ErrSCardSharingViolation = 0x8010000B /* The smart card cannot be accessed because of other connections outstanding. */
|
|
|
+ ErrSCardNoSmartCard = 0x8010000C /* The operation requires a Smart Card, but no Smart Card is currently in the device. */
|
|
|
+ ErrSCardUnknownCard = 0x8010000D /* The specified smart card name is not recognized. */
|
|
|
+ ErrSCardCannotDispose = 0x8010000E /* The system could not dispose of the media in the requested manner. */
|
|
|
+ ErrSCardProtoMismatch = 0x8010000F /* The requested protocols are incompatible with the protocol currently in use with the smart card. */
|
|
|
+ ErrSCardNotReady = 0x80100010 /* The reader or smart card is not ready to accept commands. */
|
|
|
+ ErrSCardInvalidValue = 0x80100011 /* One or more of the supplied parameters values could not be properly interpreted. */
|
|
|
+ ErrSCardSystemCancelled = 0x80100012 /* The action was cancelled by the system, presumably to log off or shut down. */
|
|
|
+ ErrSCardCommError = 0x80100013 /* An internal communications error has been detected. */
|
|
|
+ ErrScardUnknownError = 0x80100014 /* An internal error has been detected, but the source is unknown. */
|
|
|
+ ErrSCardInvalidATR = 0x80100015 /* An ATR obtained from the registry is not a valid ATR string. */
|
|
|
+ ErrSCardNotTransacted = 0x80100016 /* An attempt was made to end a non-existent transaction. */
|
|
|
+ ErrSCardReaderUnavailable = 0x80100017 /* The specified reader is not currently available for use. */
|
|
|
+ ErrSCardShutdown = 0x80100018 /* The operation has been aborted to allow the server application to exit. */
|
|
|
+ ErrSCardPCITooSmall = 0x80100019 /* The PCI Receive buffer was too small. */
|
|
|
+ ErrSCardReaderUnsupported = 0x8010001A /* The reader driver does not meet minimal requirements for support. */
|
|
|
+ ErrSCardDuplicateReader = 0x8010001B /* The reader driver did not produce a unique reader name. */
|
|
|
+ ErrSCardCardUnsupported = 0x8010001C /* The smart card does not meet minimal requirements for support. */
|
|
|
+ ErrScardNoService = 0x8010001D /* The Smart card resource manager is not running. */
|
|
|
+ ErrSCardServiceStopped = 0x8010001E /* The Smart card resource manager has shut down. */
|
|
|
+ ErrSCardUnexpected = 0x8010001F /* An unexpected card error has occurred. */
|
|
|
+ ErrSCardUnsupportedFeature = 0x8010001F /* This smart card does not support the requested feature. */
|
|
|
+ ErrSCardICCInstallation = 0x80100020 /* No primary provider can be found for the smart card. */
|
|
|
+ ErrSCardICCCreateOrder = 0x80100021 /* The requested order of object creation is not supported. */
|
|
|
+ ErrSCardDirNotFound = 0x80100023 /* The identified directory does not exist in the smart card. */
|
|
|
+ ErrSCardFileNotFound = 0x80100024 /* The identified file does not exist in the smart card. */
|
|
|
+ ErrSCardNoDir = 0x80100025 /* The supplied path does not represent a smart card directory. */
|
|
|
+ ErrSCardNoFile = 0x80100026 /* The supplied path does not represent a smart card file. */
|
|
|
+ ErrScardNoAccess = 0x80100027 /* Access is denied to this file. */
|
|
|
+ ErrSCardWriteTooMany = 0x80100028 /* The smart card does not have enough memory to store the information. */
|
|
|
+ ErrSCardBadSeek = 0x80100029 /* There was an error trying to set the smart card file object pointer. */
|
|
|
+ ErrSCardInvalidCHV = 0x8010002A /* The supplied PIN is incorrect. */
|
|
|
+ ErrSCardUnknownResMNG = 0x8010002B /* An unrecognized error code was returned from a layered component. */
|
|
|
+ ErrSCardNoSuchCertificate = 0x8010002C /* The requested certificate does not exist. */
|
|
|
+ ErrSCardCertificateUnavailable = 0x8010002D /* The requested certificate could not be obtained. */
|
|
|
+ ErrSCardNoReadersAvailable = 0x8010002E /* Cannot find a smart card reader. */
|
|
|
+ ErrSCardCommDataLost = 0x8010002F /* A communications error with the smart card has been detected. Retry the operation. */
|
|
|
+ ErrScardNoKeyContainer = 0x80100030 /* The requested key container does not exist on the smart card. */
|
|
|
+ ErrSCardServerTooBusy = 0x80100031 /* The Smart Card Resource Manager is too busy to complete this operation. */
|
|
|
+ ErrSCardUnsupportedCard = 0x80100065 /* The reader cannot communicate with the card, due to ATR string configuration conflicts. */
|
|
|
+ ErrSCardUnresponsiveCard = 0x80100066 /* The smart card is not responding to a reset. */
|
|
|
+ ErrSCardUnpoweredCard = 0x80100067 /* Power has been removed from the smart card, so that further communication is not possible. */
|
|
|
+ ErrSCardResetCard = 0x80100068 /* The smart card has been reset, so any shared state information is invalid. */
|
|
|
+ ErrSCardRemovedCard = 0x80100069 /* The smart card has been removed, so further communication is not possible. */
|
|
|
+ ErrSCardSecurityViolation = 0x8010006A /* Access was denied because of a security violation. */
|
|
|
+ ErrSCardWrongCHV = 0x8010006B /* The card cannot be accessed because the wrong PIN was presented. */
|
|
|
+ ErrSCardCHVBlocked = 0x8010006C /* The card cannot be accessed because the maximum number of PIN entry attempts has been reached. */
|
|
|
+ ErrSCardEOF = 0x8010006D /* The end of the smart card file has been reached. */
|
|
|
+ ErrSCardCancelledByUser = 0x8010006E /* The user pressed "Cancel" on a Smart Card Selection Dialog. */
|
|
|
+ ErrSCardCardNotAuthenticated = 0x8010006F /* No PIN was presented to the smart card. */
|
|
|
+)
|
|
|
+
|
|
|
+// Code returns the error code, with an uint32 type to be used in PutUInt32
|
|
|
+func (code ErrorCode) Code() uint32 {
|
|
|
+ return uint32(code)
|
|
|
+}
|
|
|
+
|
|
|
+func (code ErrorCode) Error() error {
|
|
|
+ switch code {
|
|
|
+ case SCardSuccess:
|
|
|
+ return fmt.Errorf("Command successful")
|
|
|
+
|
|
|
+ case ErrSCardInternal:
|
|
|
+ return fmt.Errorf("Internal error")
|
|
|
+
|
|
|
+ case ErrSCardCancelled:
|
|
|
+ return fmt.Errorf("Command cancelled")
|
|
|
+
|
|
|
+ case ErrSCardInvalidHandle:
|
|
|
+ return fmt.Errorf("Invalid handle")
|
|
|
+
|
|
|
+ case ErrSCardInvalidParameter:
|
|
|
+ return fmt.Errorf("Invalid parameter given")
|
|
|
+
|
|
|
+ case ErrSCardInvalidTarget:
|
|
|
+ return fmt.Errorf("Invalid target given")
|
|
|
+
|
|
|
+ case ErrSCardNoMemory:
|
|
|
+ return fmt.Errorf("Not enough memory")
|
|
|
+
|
|
|
+ case ErrSCardWaitedTooLong:
|
|
|
+ return fmt.Errorf("Waited too long")
|
|
|
+
|
|
|
+ case ErrSCardInsufficientBuffer:
|
|
|
+ return fmt.Errorf("Insufficient buffer")
|
|
|
+
|
|
|
+ case ErrScardUnknownReader:
|
|
|
+ return fmt.Errorf("Unknown reader specified")
|
|
|
+
|
|
|
+ case ErrSCardTimeout:
|
|
|
+ return fmt.Errorf("Command timeout")
|
|
|
+
|
|
|
+ case ErrSCardSharingViolation:
|
|
|
+ return fmt.Errorf("Sharing violation")
|
|
|
+
|
|
|
+ case ErrSCardNoSmartCard:
|
|
|
+ return fmt.Errorf("No smart card inserted")
|
|
|
+
|
|
|
+ case ErrSCardUnknownCard:
|
|
|
+ return fmt.Errorf("Unknown card")
|
|
|
+
|
|
|
+ case ErrSCardCannotDispose:
|
|
|
+ return fmt.Errorf("Cannot dispose handle")
|
|
|
+
|
|
|
+ case ErrSCardProtoMismatch:
|
|
|
+ return fmt.Errorf("Card protocol mismatch")
|
|
|
+
|
|
|
+ case ErrSCardNotReady:
|
|
|
+ return fmt.Errorf("Subsystem not ready")
|
|
|
+
|
|
|
+ case ErrSCardInvalidValue:
|
|
|
+ return fmt.Errorf("Invalid value given")
|
|
|
+
|
|
|
+ case ErrSCardSystemCancelled:
|
|
|
+ return fmt.Errorf("System cancelled")
|
|
|
+
|
|
|
+ case ErrSCardCommError:
|
|
|
+ return fmt.Errorf("RPC transport error")
|
|
|
+
|
|
|
+ case ErrScardUnknownError:
|
|
|
+ return fmt.Errorf("Unknown error")
|
|
|
+
|
|
|
+ case ErrSCardInvalidATR:
|
|
|
+ return fmt.Errorf("Invalid ATR")
|
|
|
+
|
|
|
+ case ErrSCardNotTransacted:
|
|
|
+ return fmt.Errorf("Transaction failed")
|
|
|
+
|
|
|
+ case ErrSCardReaderUnavailable:
|
|
|
+ return fmt.Errorf("Reader is unavailable")
|
|
|
+
|
|
|
+ /* case SCARD_P_SHUTDOWN: */
|
|
|
+ case ErrSCardPCITooSmall:
|
|
|
+ return fmt.Errorf("PCI struct too small")
|
|
|
+
|
|
|
+ case ErrSCardReaderUnsupported:
|
|
|
+ return fmt.Errorf("Reader is unsupported")
|
|
|
+
|
|
|
+ case ErrSCardDuplicateReader:
|
|
|
+ return fmt.Errorf("Reader already exists")
|
|
|
+
|
|
|
+ case ErrSCardCardUnsupported:
|
|
|
+ return fmt.Errorf("Card is unsupported")
|
|
|
+
|
|
|
+ case ErrScardNoService:
|
|
|
+ return fmt.Errorf("Service not available")
|
|
|
+
|
|
|
+ case ErrSCardServiceStopped:
|
|
|
+ return fmt.Errorf("Service was stopped")
|
|
|
+
|
|
|
+ /* case SCARD_E_UNEXPECTED: */
|
|
|
+ /* case SCARD_E_ICC_CREATEORDER: */
|
|
|
+ /* case SCARD_E_UNSUPPORTED_FEATURE: */
|
|
|
+ /* case SCARD_E_DIR_NOT_FOUND: */
|
|
|
+ /* case SCARD_E_NO_DIR: */
|
|
|
+ /* case SCARD_E_NO_FILE: */
|
|
|
+ /* case SCARD_E_NO_ACCESS: */
|
|
|
+ /* case SCARD_E_WRITE_TOO_MANY: */
|
|
|
+ /* case SCARD_E_BAD_SEEK: */
|
|
|
+ /* case SCARD_E_INVALID_CHV: */
|
|
|
+ /* case SCARD_E_UNKNOWN_RES_MNG: */
|
|
|
+ /* case SCARD_E_NO_SUCH_CERTIFICATE: */
|
|
|
+ /* case SCARD_E_CERTIFICATE_UNAVAILABLE: */
|
|
|
+ case ErrSCardNoReadersAvailable:
|
|
|
+ return fmt.Errorf("Cannot find a smart card reader")
|
|
|
+
|
|
|
+ /* case SCARD_E_COMM_DATA_LOST: */
|
|
|
+ /* case SCARD_E_NO_KEY_CONTAINER: */
|
|
|
+ /* case SCARD_E_SERVER_TOO_BUSY: */
|
|
|
+ case ErrSCardUnsupportedCard:
|
|
|
+ return fmt.Errorf("Card is not supported")
|
|
|
+
|
|
|
+ case ErrSCardUnresponsiveCard:
|
|
|
+ return fmt.Errorf("Card is unresponsive")
|
|
|
+
|
|
|
+ case ErrSCardUnpoweredCard:
|
|
|
+ return fmt.Errorf("Card is unpowered")
|
|
|
+
|
|
|
+ case ErrSCardResetCard:
|
|
|
+ return fmt.Errorf("Card was reset")
|
|
|
+
|
|
|
+ case ErrSCardRemovedCard:
|
|
|
+ return fmt.Errorf("Card was removed")
|
|
|
+
|
|
|
+ /* case SCARD_W_SECURITY_VIOLATION: */
|
|
|
+ /* case SCARD_W_WRONG_CHV: */
|
|
|
+ /* case SCARD_W_CHV_BLOCKED: */
|
|
|
+ /* case SCARD_W_EOF: */
|
|
|
+ /* case SCARD_W_CANCELLED_BY_USER: */
|
|
|
+ /* case SCARD_W_CARD_NOT_AUTHENTICATED: */
|
|
|
+
|
|
|
+ case ErrSCardUnsupportedFeature:
|
|
|
+ return fmt.Errorf("Feature not supported")
|
|
|
+
|
|
|
+ default:
|
|
|
+ return fmt.Errorf("unknown error: %08x", code)
|
|
|
+ }
|
|
|
+}
|