SslGetKeyProperty 関数

  • [アーティクル]

SslGetKeyProperty 関数は、Secure Sockets Layer プロトコル (SSL) プロバイダー キー オブジェクトの名前付きプロパティの値を取得します。

構文

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

パラメーター

hKey [in]

SSL プロバイダーのハンドル。

pszProperty [in]

取得するプロパティの名前を含む null で終わる Unicode 文字列へのポインター。 これには、定義済みの キー ストレージ プロパティ識別子またはカスタム プロパティ識別子 のいずれかを指定できます。

ppbOutput [out]

プロパティ値を受け取るバッファーへのポインター。 関数の呼び出し元は、 SslFreeBuffer 関数を呼び出して、このバッファーを解放する必要があります。

pcbOutput [out]

pbOutput バッファーのサイズ (バイト単位)。

dwFlags [in]

このパラメーターは将来使用するために予約されています。

戻り値

関数が成功すると、0 が返されます。

関数が失敗すると、0 以外のエラー値が返されます。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード/値 説明
NTE_INVALID_HANDLE
0x80090026L
 指定されたハンドルの 1 つが無効です。
NTE_INVALID_PARAMETER
0x80090027L
 指定されたパラメーターの 1 つが無効です。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Sslprovider.h
[DLL]
Ncrypt.dll