CryptSetKeyIdentifierProperty

CryptSetKeyIdentifierProperty 関数は指定された鍵識別子のプロパティを設定する。この関数は pwszComputerName で識別されるコンピュータ上のプロパティを設定できる。

CryptSetKeyIdentifierProperty pKeyIdentifier, dwPropId, dwFlags, pwszComputerName, pvReserved, pvData

pKeyIdentifier : [var] 鍵識別子を含む CRYPT_HASH_BLOB へのポインタ。
dwPropId : [int] 設定するプロパティを識別する。dwPropId の値が pvData パラメータの型と内容を決定する。任意の証明書プロパティ ID を使用できる。最も関心のあるプロパティは CERT_KEY_PROV_INFO_PROP_ID である。
dwFlags : [int] 次のフラグを設定できる。これらはビットごとの OR 演算で組み合わせることができる。
pwszComputerName : [wstr] プロパティを設定する鍵識別子を持つリモートコンピュータの名前を含む NULL 終端文字列へのポインタ。CRYPT_KEYID_MACHINE_FLAG フラグが設定されている場合、リモートコンピュータから鍵識別子の一覧が検索される。リモートコンピュータではなくローカルコンピュータに設定する場合、pwszComputerName を NULL に設定する。
pvReserved : [intptr] 将来使用のために予約されており、NULL でなければならない。
pvData : [intptr] dwPropId が CERT_KEY_PROV_INFO_PROP_ID の場合、pvData は鍵識別子のプロパティを含む CRYPT_KEY_PROV_INFO 構造体を指す。

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

解説

CryptSetKeyIdentifierProperty 関数は指定された鍵識別子のプロパティを設定する。この関数は
pwszComputerName で識別されるコンピュータ上のプロパティを設定できる。

[戻り値]
関数が成功した場合、戻り値は 0 以外 (TRUE)。関数が失敗した場合、戻り値は 0 (FALSE)。拡張エラー情報を取得するには
GetLastError を呼び出す。注意 CRYPT_KEYID_SET_NEW_FLAG
が設定されており、プロパティがすでに存在する場合、最終エラーコードを CRYPT_E_EXISTS に設定して FALSE が返される。

情報