GetSidIdentifierAuthority 関数 (securitybaseapi.h)

GetSidIdentifierAuthority 関数は、指定されたセキュリティ識別子 (SID) のSID_IDENTIFIER_AUTHORITY構造体へのポインターを返します。

構文

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

パラメーター

[in] pSid

SID_IDENTIFIER_AUTHORITY構造体へのポインターが返される SID 構造体へのポインター。

この関数は、無効な SID 構造体を処理しません。 IsValidSid 関数を呼び出して、この関数を呼び出す前に SID 構造体が有効であることを確認します。

戻り値

関数が成功した場合、戻り値は、指定した SID 構造体のSID_IDENTIFIER_AUTHORITY構造体へのポインターです。

関数が失敗した場合、戻り値は未定義です。 pSid パラメーターが指す SID 構造体が無効な場合、関数は失敗します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数では、32 ビット RID 値が使用されます。 より大きな RID 値を必要とするアプリケーションの場合は、 CreateWellKnownSid および関連関数を使用します。

要件

要件
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー securitybaseapi.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

こちらもご覧ください

アクセス制御の概要

基本的なAccess Control関数

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY