247 lines
12 KiB
Go
247 lines
12 KiB
Go
// 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)
|
|
}
|
|
}
|