SCardIsValidContext 函式 (winscard.h)

SCardIsValidContext 函式會判斷智慧卡內容句柄是否有效。

語法

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

參數

[in] hContext

識別 資源管理員內容的句柄。 資源管理員內容可以透過先前對 SCardEstablishContext 的呼叫來設定。

傳回值

此函式會傳回下列其中一個值。

備註

呼叫此函式以判斷 智慧卡 內容句柄是否仍然有效。 SCardEstablishContext 設定智慧卡內容句柄之後，如果資源管理員服務已關閉，它可能會變成無效。

範例

下列範例顯示判斷智慧卡內容句柄是否有效。

// Check the smart card context handle.
// hContext was set previously by SCardEstablishContext.

LONG    lReturn;
lReturn = SCardIsValidContext(hContext);
if ( SCARD_S_SUCCESS != lReturn )
{
    // Function failed; check return value.
    if ( ERROR_INVALID_HANDLE == lReturn )
        printf("Handle is invalid\n");
    else
    {
        // Some unexpected error occurred; report and bail out.
        printf("Failed SCardIsValidContext - %x\n", lReturn);
        exit(1);  // Or other appropriate error action.
    }
}
else
{
    // Handle is valid; proceed as needed.
    // ...
}

規格需求

另請參閱

SCardEstablishContext