LookupAccountSidW

セキュリティ識別子 (SID) を入力として受け取る。この SID のアカウント名と、この SID が見つかった最初のドメインの名前を取得する。(Unicode)

LookupAccountSidW lpSystemName, Sid, Name, cchName, ReferencedDomainName, cchReferencedDomainName, peUse

lpSystemName : [wstr] 対象コンピュータを指定する null 終端文字列へのポインタ。この文字列はリモートコンピュータの名前でもよい。このパラメータが NULL の場合、アカウント名の変換はローカルシステムで開始される。ローカルシステムで名前を解決できない場合、この関数はローカルシステムが信頼するドメインコントローラを使用して名前を解決しようとする。
Sid : [int] ルックアップする SID へのポインタ。
Name : [wstr] lpSid パラメータに対応するアカウント名を含む null 終端文字列を受け取るバッファへのポインタ。
cchName : [var] 入力時、lpName バッファのサイズを TCHAR 単位で指定する。バッファが小さすぎて関数が失敗した場合、または cchName が 0 の場合、cchName は終端 null 文字を含む必要なバッファサイズを受け取る。
ReferencedDomainName : [wstr] アカウント名が見つかったドメインの名前を含む null 終端文字列を受け取るバッファへのポインタ。サーバーでは、ローカルコンピュータのセキュリティデータベース内のほとんどのアカウントに対して返されるドメイン名は、そのサーバーがドメインコントローラとなっているドメインの名前である。
cchReferencedDomainName : [var] 入力時、lpReferencedDomainName バッファのサイズを TCHAR 単位で指定する。バッファが小さすぎて関数が失敗した場合、または cchReferencedDomainName が 0 の場合、cchReferencedDomainName は終端 null 文字を含む必要なバッファサイズを受け取る。
peUse : [var] アカウントの種類を示す SID_NAME_USE 値を受け取る変数へのポインタ。

(プラグイン / モジュール : advapi32.dll)

解説

セキュリティ識別子 (SID) を入力として受け取る。この SID のアカウント名と、この SID
が見つかった最初のドメインの名前を取得する。(Unicode)

[戻り値]
関数が成功した場合、関数は 0 以外を返す。関数が失敗した場合、0 を返す。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
LookupAccountSid 関数は、まず既知の SID のリストを確認することによって、指定された SID
の名前を見つけようとする。指定された SID が既知の SID
に対応しない場合、関数は組み込みおよび管理上定義されたローカルアカウントを確認する。次に、関数はプライマリドメインを確認する。プライマリドメインで認識されないセキュリティ識別子は、その
SID プレフィックスに対応する信頼されたドメインと照合される。関数が SID
のアカウント名を見つけられない場合、GetLastError は ERROR_NONE_MAPPED
を返す。これはネットワークタイムアウトが関数が名前を見つけることを妨げた場合に発生することがある。また、ログオンセッションを識別するログオン
SID のように対応するアカウント名がない SID
でも発生する。ローカルアカウント、ローカルドメインアカウント、明示的に信頼されたドメインアカウントの SID
の検索に加えて、LookupAccountSid はフォレスト内の任意のドメインの任意のアカウントの SID
を検索できる。これには、フォレスト内のアカウントの SIDhistory フィールドにのみ現れる SID も含まれる。SIDhistory
フィールドは、別のドメインから移動されたアカウントの以前の SID を保存する。SID
をルックアップするために、LookupAccountSid はフォレストのグローバルカタログをクエリする。

情報