PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET

BOOL PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET(
    void* pPluginContext,
    CRYPT_INTEGER_BLOB* pIdentifier,
    DWORD dwNameType,
    CRYPT_INTEGER_BLOB* pNameBlob,
    BYTE** ppbContent,
    DWORD* pcbContent,
    LPWSTR* ppwszPassword,
    CRYPT_INTEGER_BLOB** ppIdentifier
);

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET コールバック関数は、オブジェクトを取得します。この関数は、カスタムプロバイダーの一部として実装する必要があります。現在この関数を呼び出すのは、Secure Channel (Schannel) セキュリティパッケージのみです。

関数が成功した場合は、0 以外の値 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返し、SetLastError 関数で適切なエラーを指定します。ほとんどのエラーは変更されずに Schannel を通過しますが、この動作は保証されません。一部のエラーは、別のエラーにマップされる場合があります。

指定された DNS 名 (pNameBlob) または識別子 (pIdentifier) に対してオブジェクトを返せない場合は、FALSE を返し、SetLastError 関数で CRYPT_E_OBJECT_LOCATOR_OBJECT_NOT_FOUND を指定します。

現在 PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET コールバック関数を呼び出すのは、Secure Channel (Schannel) セキュリティパッケージのみです。次のいずれかをカプセル化したオブジェクトを返すことができます。

• 個人情報交換 (PFX) のバイト配列
• 証明書ストア。
• 汎用の BLOB。これは現在 Schannel ではサポートされていません。

この関数が最初に呼び出されるとき、Schannel は pNameBlob 引数に DNS ホスト名を渡し、オブジェクトの対象となるホストを指定します。プロバイダーは、この名前を処理して (ワイルドカードの照合、ファイルパスの構築など)、どのオブジェクトを検索するかを判断する必要があります。

多数のホスト名を 1 つのオブジェクトに対応付けできるため、プロバイダーは ppIdentifier パラメーターを使用して、内部的に定義した識別子を返すことができます。この識別子は、暗号化 API (CAPI) 関数からプロバイダーへの後続の呼び出しで使用できます。プロバイダーは、この識別子を利用して適切なオブジェクトを見つけやすくできます。