CredUnprotectW 関数 (wincred.h)

  • [アーティクル]

CredUnprotect 関数は、CredProtect 関数を使用して以前に暗号化された資格情報を復号化します。 資格情報は、 CredUnprotect が呼び出されるのと同じセキュリティ コンテキストで暗号化されている必要があります。

構文

BOOL CredUnprotectW(
  [in]      BOOL   fAsSelf,
  [in]      LPWSTR pszProtectedCredentials,
  [in]      DWORD  cchProtectedCredentials,
  [out]     LPWSTR pszCredentials,
  [in, out] DWORD  *pcchMaxChars
);

パラメーター

[in] fAsSelf

現在のプロセスのセキュリティ コンテキストで資格情報が暗号化されたことを指定するには、 TRUE に設定します。 呼び出し元のスレッド セキュリティ コンテキストのセキュリティ コンテキストで資格情報が暗号化されたことを指定するには 、FALSE に 設定します。

[in] pszProtectedCredentials

暗号化された資格情報を指定する文字列へのポインター。

[in] cchProtectedCredentials

pszProtectedCredentials バッファーのサイズ (文字数)。

[out] pszCredentials

出力時に復号化された資格情報を受け取る文字列へのポインター。

[in, out] pcchMaxChars

pszCredentials バッファーの文字単位のサイズ。 出力時に、 pszCredentials が暗号化された資格情報を受信するのに十分なサイズでない場合、このパラメーターは pszCredentials バッファーの必要なサイズを文字数で指定します。

戻り値

関数が成功した場合は TRUE。それ以外の場合は FALSE。

拡張エラー情報については、 GetLastError 関数を呼び出します。 次の表は 、GetLastError 関数の一般的な値を示しています。

リターン コード/値 Description
ERROR_NOT_CAPABLE
 資格情報の暗号化に使用されるセキュリティ コンテキストは、資格情報の暗号化解除に使用されるセキュリティ コンテキストとは異なります。
ERROR_INSUFFICIENT_BUFFER
 pszCredentials バッファーのサイズが不十分でした。

解説

注意

wincred.h ヘッダーは CredUnprotect をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wincred.h
Library Advapi32.lib
[DLL] Advapi32.dll