SCardGetProviderIdW 関数 (winscard.h)

[アーティクル]
08/27/2023

SCardGetProviderId 関数は、特定のカードのプライマリサービスプロバイダーの識別子 (GUID) を返します。

呼び出し元は、スマートカードの名前 (以前にシステムに導入されました) を提供し、プライマリサービスプロバイダー GUID の登録済み識別子 (存在する場合) を受け取ります。

構文

LONG SCardGetProviderIdW(
  [in]  SCARDCONTEXT hContext,
  [in]  LPCWSTR      szCard,
  [out] LPGUID       pguidProviderId
);

パラメーター

[in] hContext

クエリのリソースマネージャーコンテキストを識別するハンドル。リソースマネージャーコンテキストは、 SCardEstablishContext の以前の呼び出しによって設定できます。このパラメーターを NULL にすることはできません。

[in] szCard

システムに定義されているカードの名前。

[out] pguidProviderId

プライマリサービスプロバイダーの識別子 (GUID)。このプロバイダーは COM を使用してアクティブ化することができ、カード内の他のサービスへのアクセスを提供します。

戻り値

この関数は、成功するか失敗するかによって異なる値を返します。

リターンコード	説明
Success	SCARD_S_SUCCESS。
障害	エラーコード。詳細については、「スマートカードの戻り値」を参照してください。

注釈

この関数はリダイレクトされませんが、リモートデスクトップセッション内で関数を呼び出してもエラーは発生しません。これは、結果がローカルコンピューターではなくリモートコンピューターからの結果であることを意味するだけです。

SCardGetProviderId 関数はデータベースクエリ関数です。その他のデータベースクエリ関数の詳細については、「スマートカードデータベースクエリ関数」を参照してください。

例

次の例は、指定したカードのプロバイダー ID を取得する方法を示しています。この例では、hContext が SCardEstablishContext 関数の以前の呼び出しから取得した有効なハンドルであり、 SCardIntroduceCardType 関数の以前の呼び出しによって "MyCardName" が導入されたと想定しています。

GUID    guidProv;
LONG    lReturn;

lReturn = SCardGetProviderId(hContext, 
                             L"MyCardName",
                             &guidProv);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardGetProviderId - %x\n", lReturn);
else
{
    // Use the provider GUID as needed.
    // ...
}

注意

winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardGetProviderId を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	winscard.h
Library	Winscard.lib
[DLL]	Winscard.dll