LookupAccountNameW

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

LookupAccountNameW lpSystemName, lpAccountName, Sid, cbSid, ReferencedDomainName, cchReferencedDomainName, peUse

lpSystemName : [wstr] システムの名前を指定する null 終端文字列へのポインタ。この文字列はリモートコンピュータの名前でもよい。この文字列が NULL の場合、アカウント名の変換はローカルシステムで開始される。ローカルシステムで名前を解決できない場合、この関数はローカルシステムが信頼するドメインコントローラを使用して名前を解決しようとする。一般に、lpSystemName の値は、アカウントが信頼されていないドメインに存在し、そのドメイン内のコンピュータ名が既知である場合にのみ指定する。
lpAccountName : [wstr] アカウント名を指定する null 終端文字列へのポインタ。LookupAccountName が目的のドメインでアカウントを確実に検索できるよう、domain_name\user_name 形式の完全修飾文字列を使用する。
Sid : [int] lpAccountName パラメータで指定されたアカウント名に対応する SID 構造体を受け取るバッファへのポインタ。このパラメータが NULL の場合、cbSid は 0 でなければならない。
cbSid : [var] 変数へのポインタ。入力時、この値は Sid バッファのサイズをバイト単位で指定する。バッファが小さすぎて関数が失敗した場合、または cbSid が 0 の場合、この変数は必要なバッファサイズを受け取る。
ReferencedDomainName : [wstr] アカウント名が見つかったドメインの名前を受け取るバッファへのポインタ。ドメインに参加していないコンピュータの場合、このバッファはコンピュータ名を受け取る。このパラメータが NULL の場合、関数は必要なバッファサイズを返す。
cchReferencedDomainName : [var] 変数へのポインタ。入力時、この値は ReferencedDomainName バッファのサイズを TCHAR 単位で指定する。バッファが小さすぎて関数が失敗した場合、この変数は終端 null 文字を含む必要なバッファサイズを受け取る。ReferencedDomainName パラメータが NULL の場合、このパラメータは 0 でなければならない。
peUse : [var] 関数が戻るときにアカウントの種類を示す SID_NAME_USE 列挙型へのポインタ。

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

解説

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

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

[備考]
LookupAccountName 関数は、まず既知の SID のリストを確認することによって、指定された名前の SID
を見つけようとする。名前が既知の SID
に対応しない場合、関数は組み込みおよび管理上定義されたローカルアカウントを確認する。次に、関数はプライマリドメインを確認する。名前がそこで見つからない場合、信頼されたドメインが確認される。完全修飾アカウント名
(例: domain_name\user_name) を孤立した名前 (例: user_name)
の代わりに使用すること。完全修飾名はあいまいでなく、ルックアップを実行する際のパフォーマンスも優れている。
> [!NOTE] > winbase.h ヘッダーは LookupAccountName をエイリアスとして定義し、UNICODE
プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択する。詳細は [Conventions
for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報