CryptGetKeyIdentifierProperty

CryptGetKeyIdentifierProperty は指定された鍵識別子から特定のプロパティを取得する。

CryptGetKeyIdentifierProperty pKeyIdentifier, dwPropId, dwFlags, pwszComputerName, pvReserved, pvData, pcbData

pKeyIdentifier : [var] 鍵識別子を含む CRYPT_HASH_BLOB へのポインタ。
dwPropId : [int] 取得するプロパティを識別する。dwPropId の値が pvData パラメータの型と内容を決定する。任意の証明書プロパティ ID を使用できる。
dwFlags : [int] 次のフラグを使用できる。これらはビットごとの OR 演算で組み合わせることができる。
pwszComputerName : [wstr] 検索するリモートコンピュータの名前へのポインタ。CRYPT_KEYID_MACHINE_FLAG フラグが設定されている場合、リモートコンピュータから鍵識別子のリストが検索される。リモートコンピュータではなくローカルコンピュータを検索する場合、pwszComputerName を NULL に設定する。
pvReserved : [intptr] 将来使用のために予約されており、NULL でなければならない。
pvData : [intptr] dwPropId によって決定されるデータを受け取るバッファへのポインタ。pvData 構造体内のフィールドが指す要素は構造体の後に続く。したがって、pcbData に含まれるサイズが構造体のサイズを超えることがある。
pcbData : [var] pvData パラメータが指すバッファのサイズ (バイト単位) を含む DWORD へのポインタ。関数が戻ると、DWORD にはバッファに格納されたバイト数が含まれる。pcbData が指す変数に含まれるサイズは、構造体が補助データへのポインタを含むことができるため、CRYPT_KEY_PROV_INFO 構造体よりも大きいサイズを示す場合がある。このサイズは構造体が必要とするサイズとすべての補助データのサイズの合計である。

(プラグイン / モジュール : crypt32.dll)

解説

CryptGetKeyIdentifierProperty は指定された鍵識別子から特定のプロパティを取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外 (TRUE)。関数が失敗した場合は 0 (FALSE) を返す。拡張エラー情報を取得するには
GetLastError を呼び出す。

情報