RtlInitializeSid 関数 (ntifs.h)

  • [アーティクル]

RtlInitializeSid ルーチンは、セキュリティ識別子 (SID) 構造体を初期化します。

構文

NTSYSAPI NTSTATUS RtlInitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount
);

パラメーター

[out] Sid

初期化する呼び出し元によって割り当てられた SID 構造体へのポインター。

[in] IdentifierAuthority

SID 構造体で設定するSID_IDENTIFIER_AUTHORITY構造体へのポインター。

[in] SubAuthorityCount

SID で設定するサブ認証の数。 サブ認証値は、次の「解説」セクションで説明するように個別に設定する必要があります。

戻り値

RtlInitializeSid は、次のいずれかを返します。

リターン コード 説明
STATUS_SUCCESS
 SID が正常に初期化されました。
STATUS_INVALID_PARAMETER
 指定された SubAuthorityCount 値が無効です。

注釈

RtlInitializeSid は SID のサブ認証の数を設定しますが、サブ認証値は設定しません。 これは 、RtlSubAuthoritySid を呼び出して個別に行う必要があります。

セキュリティとアクセス制御の詳細については、 ドライバー開発者向けの Windows セキュリティ モデル と、Windows SDK のこれらのトピックに関するドキュメントを参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000
対象プラットフォーム ユニバーサル
Header ntifs.h (Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe (カーネル モード);Ntdll.dll (ユーザー モード)
IRQL < DISPATCH_LEVEL

こちらもご覧ください

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY