CredUnprotectA 関数 (wincred.h)
CredUnprotect 関数は、CredProtect 関数を使用して、以前に暗号化された資格情報を復号化します。 資格情報は、credUnprotect が呼び出されるのと同じセキュリティ コンテキスト
構文
BOOL CredUnprotectA(
[in] BOOL fAsSelf,
[in] LPSTR pszProtectedCredentials,
[in] DWORD cchProtectedCredentials,
[out] LPSTR pszCredentials,
[in, out] DWORD *pcchMaxChars
);
パラメーター
[in] fAsSelf
現在 プロセスのセキュリティ コンテキストで資格情報が暗号化されたことを指定するには、TRUE に設定します。 呼び出し元のスレッド セキュリティ コンテキストのセキュリティ コンテキストで資格情報が暗号化されたことを指定するには、FALSE を
[in] pszProtectedCredentials
暗号化された資格情報を指定する文字列へのポインター。
[in] cchProtectedCredentials
pszProtectedCredentials バッファーのサイズ (文字単位)。
[out] pszCredentials
出力時に復号化された資格情報を受け取る文字列へのポインター。
[in, out] pcchMaxChars
pszCredentials バッファーの文字単位のサイズ。 出力時に、pszCredentials が暗号化された資格情報を受信するのに十分なサイズでない場合、このパラメーターは、pszCredentials バッファーの必要なサイズを文字で指定します。
戻り値
関数が成功した場合は TRUE を
拡張エラー情報については、GetLastError 関数を呼び出します。 次の表に、GetLastError 関数の一般的な値を示します。
戻りコード/値 | 形容 |
---|---|
|
資格情報の暗号化に使用されるセキュリティ コンテキストは、資格情報の暗号化を解除するために使用されるセキュリティ コンテキストとは異なります。 |
|
pszCredentials バッファーのサイズが不十分でした。 |
備考
手記
wincred.h ヘッダーは CredUnprotect をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2008 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wincred.h |
ライブラリ | Advapi32.lib |
DLL | Advapi32.dll |