NCryptGetProtectionDescriptorInfo 関数 (ncryptprotect.h)

  • [アーティクル]

NCryptGetProtectionDescriptorInfo 関数は、保護記述子ルール文字列を取得します。

構文

SECURITY_STATUS NCryptGetProtectionDescriptorInfo(
  [in]           NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  [in, optional] const NCRYPT_ALLOC_PARA  *pMemPara,
                 DWORD                    dwInfoType,
  [out]          void                     **ppvInfo
);

パラメーター

[in] hDescriptor

NCryptCreateProtectionDescriptor を呼び出して作成された保護記述子ハンドル。

[in, optional] pMemPara

カスタム メモリ管理機能を指定するために使用できる NCRYPT_ALLOC_PARA 構造体へのポインター。 この引数を NULL に設定した場合、 LocalAlloc 関数はメモリを割り当てるために内部的に使用され、アプリケーションは LocalFree を呼び出して 、ppvInfo パラメーターが指すメモリを解放する必要があります。

dwInfoType

記述子情報を ppvInfo パラメーターに返す方法を指定します。 次の値を指定できます。

値 説明
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING
 ppvInfo 引数は記述子ルール文字列を返します。

[out] ppvInfo

記述子情報へのポインター。

戻り値

関数の成功または失敗を示す状態コードを返します。 可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード 説明
ERROR_SUCCESS
 関数は成功しました。
NTE_INVALID_PARAMETER
 ppvInfo パラメーターを NULL にすることはできません。
NTE_NOT_SUPPORTED
 dwInfoType パラメーターでサポートされていない値が指定されました。
NTE_INVALID_HANDLE
 hDescriptor パラメーターで指定されたハンドルが無効です。

要件

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

関連項目

CNG DPAPI 関数

NCryptCreateProtectionDescriptor