SECURITY_ATTRIBUTES 構造体 (wtypesbase.h)

SECURITY_ATTRIBUTES構造体には、オブジェクトのセキュリティ記述子が含まれており、この構造体を指定して取得されたハンドルが継承可能かどうかを指定します。 この構造体は、CreateFile、CreatePipe、CreateProcess、RegCreateKeyEx、RegSaveKeyEx など、さまざまな関数によって作成されたオブジェクトのセキュリティ設定を提供します。

構文

typedef struct _SECURITY_ATTRIBUTES {
  DWORD  nLength;
  LPVOID lpSecurityDescriptor;
  BOOL   bInheritHandle;
} SECURITY_ATTRIBUTES, *PSECURITY_ATTRIBUTES, *LPSECURITY_ATTRIBUTES;

メンバー

nLength

この構造体のサイズ (バイト単位)。 この値を 、SECURITY_ATTRIBUTES 構造体のサイズに設定します。

lpSecurityDescriptor

オブジェクトへのアクセスを制御する SECURITY_DESCRIPTOR 構造体へのポインター。 このメンバーの値が NULL の場合、オブジェクトには呼び出し元プロセスの アクセス トークン に関連付けられている既定のセキュリティ記述子が割り当てられます。 これは、 NULL随意アクセス制御リスト (DACL) を割り当ててすべてのユーザーにアクセス権を付与するのと同じではありません。 既定では、プロセスのアクセス トークンの既定の DACL では、アクセス トークンによって表されるユーザーにのみアクセスが許可されます。

セキュリティ記述子の作成の詳細については、「セキュリティ記述子 の作成」を参照してください。

bInheritHandle

新しいプロセスの作成時に返されるハンドルを継承するかどうかを指定するブール値。 このメンバーが TRUE の場合、新しいプロセスはハンドルを継承します。

要件

要件	値
サポートされている最小のクライアント	Windows XP
サポートされている最小のサーバー	Windows Server 2003
Header	wtypesbase.h