次の方法で共有

CredProtectW 関数 (wincred.h)

  • [アーティクル]

CredProtect 関数は、指定された資格情報を暗号化して、現在のセキュリティ コンテキストのみが暗号化を解除できるようにします。

構文

BOOL CredProtectW(
  [in]      BOOL                 fAsSelf,
  [in]      LPWSTR               pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPWSTR               pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

パラメーター

[in] fAsSelf

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

[in] pszCredentials

暗号化する資格情報を指定する文字列へのポインター。 この関数は、cchCredentials パラメーターで指定された文字数を暗号化します。

[in] cchCredentials

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

[out] pszProtectedCredentials

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

[in, out] pcchMaxChars

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

[out] ProtectionType

出力時に提供される保護の種類を指定する CRED_PROTECTION_TYPE 列挙型へのポインター。

戻り値

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

拡張エラー情報については、GetLastError 関数を呼び出します。

備考

CredProtect 関数の出力は整合性が保護されていないため、出力が変更された場合、CredUnprotect 関数は更新されず、正しくない結果が生成される可能性があります。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wincred.h
ライブラリ Advapi32.lib
DLL Advapi32.dll