WNetGetUserW 関数 (winnetwk.h)

[アーティクル]
03/13/2024

WNetGetUser 関数は、現在の既定のユーザー名、またはネットワーク接続の確立に使用されるユーザー名を取得します。

構文

DWORD WNetGetUserW(
  [in]      LPCWSTR lpName,
  [out]     LPWSTR  lpUserName,
  [in, out] LPDWORD lpnLength
);

パラメーター

[in] lpName

ネットワークリソースにリダイレクトされたローカルデバイスの名前、またはローカルデバイスをリダイレクトせずに接続が確立されたネットワークリソースのリモート名を指定する、 null で終わる定数文字列へのポインター。

このパラメーターが NULL または空の文字列の場合、システムはプロセスの現在のユーザーの名前を返します。

[out] lpUserName

null で終わるユーザー名を受け取るバッファーへのポインター。

[in, out] lpnLength

lpUserName バッファーのサイズを文字数で指定する変数へのポインター。バッファーが十分な大きさでないために呼び出しが失敗した場合、この変数には必要なバッファーサイズが含まれます。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値はシステムエラーコード (次のいずれかの値など) になります。

リターンコード	説明
ERROR_NOT_CONNECTED	lpName パラメーターで指定されたデバイスは、リダイレクトされたデバイスまたは接続されたネットワーク名ではありません。
ERROR_MORE_DATA	以降の呼び出しでは、さらに多くのエントリを使用できます。
ERROR_NO_NETWORK	ネットワークが利用できません。
ERROR_EXTENDED_ERROR	ネットワーク固有のエラーが発生しました。エラーの説明を取得するには、 WNetGetLastError 関数を呼び出します。
ERROR_NO_NET_OR_BAD_PATH	どのプロバイダーも、ローカル名が接続を持つものとして認識しません。ただし、接続が属している可能性のある少なくとも 1 つのプロバイダーでは、ネットワークを使用できません。

注釈

WNetGetUser 関数は、分散ファイルシステム (DFS) 上の共有を認識しません。 lpName パラメーターで指定された名前が、DFS 共有または DFS 共有を表すリモートリソースにリダイレクトされるローカルデバイスである場合、WNetGetUser 関数はERROR_NOT_CONNECTEDで失敗します。

例

次のコードサンプルは、 WNetGetUser 関数を使用して、リダイレクトされたローカルデバイスまたはリモートネットワークリソースに関連付けられているユーザーの名前を取得する方法を示しています。

#ifndef UNICODE
#define UNICODE
#endif
#pragma comment(lib, "mpr.lib")

#include <windows.h>
#include <tchar.h>
#include <stdio.h>
#include <Winnetwk.h>

int wmain(int argc, wchar_t * argv[])
{
    DWORD dwRetVal;

    WCHAR UserName[MAX_PATH];

    DWORD dwNameLength = MAX_PATH;

    if (argc != 2) {
        wprintf
            (L"Usage: %s [Redirected-LocalDevice or Network-Resource-Remote-name\n",
             argv[0]);
        exit(1);
    }

    wprintf(L"Calling WNetGetUser with Network-Resource = %s\n", argv[1]);

    dwRetVal = WNetGetUser(argv[1], UserName, &dwNameLength);
    //
    // If the call succeeds, print the user information.
    //
    if (dwRetVal == NO_ERROR) {

        wprintf(L"WNetGetUser returned success\n");
        wprintf(L"\tUsername=%s   NameLength=%d\n", &UserName, dwNameLength);
        exit(0);
    }

    else {
        wprintf(L"WNetGetUser failed with error: %u\n", dwRetVal);
        exit(1);
    }
}

注意

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetGetUser を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winnetwk.h
Library	Mpr.lib
[DLL]	Mpr.dll