NetWkstaUserSetInfo 함수(lmwksta.h)

아티클
08/24/2023

NetWkstaUserSetInfo 함수는 워크스테이션의 구성 요소에 대한 사용자별 정보를 설정합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetWkstaUserSetInfo(
        LMSTR   reserved,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

매개 변수

reserved

이 매개 변수는 0으로 설정해야 합니다.

[in] level

데이터의 정보 수준을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
1	현재 사용자의 이름 및 워크스테이션에서 액세스하는 도메인을 포함하여 워크스테이션에 대한 정보를 지정합니다. buf 매개 변수는 WKSTA_USER_INFO_1 구조를 가리킵니다.
1101	워크스테이션에서 검색한 도메인을 지정합니다. buf 매개 변수는 WKSTA_USER_INFO_1101 구조를 가리킵니다.

[in] buf

데이터를 지정하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 수준 매개 변수의 값에 따라 달라집니다. 자세한 내용은 네트워크 관리 함수 버퍼를 참조하세요.

[out] parm_err

ERROR_INVALID_PARAMETER 오류를 일으키는 첫 번째 매개 변수의 인덱스를 수신하는 값에 대한 포인터입니다. 이 매개 변수가 NULL이면 인덱스가 오류로 반환되지 않습니다.

반환 값

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_INVALID_LEVEL	수준 매개 변수가 잘못되었습니다.
ERROR_INVALID_PARAMETER	함수 매개 변수 중 하나가 잘못되었습니다.

설명

NetWkstaUserSetInfo 함수는 로컬에서만 작동합니다. 관리자 그룹 멤버 자격이 필요합니다.

WKSTA_USER_INFO_1101 구조체의 wkui1101_oth_domains 멤버에 있는 도메인 이름은 공백으로 구분됩니다. 빈 목록이 유효합니다. NULL 포인터는 멤버를 수정되지 않은 상태로 두는 것을 의미합니다. MS-DOS를 사용하여 wkui1101_oth_domains 멤버를 설정할 수 없습니다. 이 요소를 설정할 때 NetWkstaUserSetInfo 는 이름 목록이 유효하지 않거나 시스템에서 관리하는 하나 이상의 네트워크 어댑터에 이름을 추가할 수 없는 경우 요청을 거부합니다.

NetWkstaUserSetInfo 함수가 ERROR_INVALID_PARAMETER 반환하는 경우 parm_err 매개 변수를 사용하여 잘못된 워크스테이션 사용자 정보 구조의 멤버를 나타낼 수 있습니다. 워크스테이션 사용자 정보 구조는 WKSTA_USER_INFO_ 시작하며 해당 형식은 수준 매개 변수로 지정됩니다. 다음 표에서는 parm_err 매개 변수에 반환할 수 있는 값과 오류가 발생한 해당 구조체 멤버를 나열합니다. (접두사 wkui*_는 멤버가 여러 접두사(예: wkui0_ 또는 wkui1_)로 시작할 수 있음을 나타냅니다.

값	멤버
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

예제

다음 코드 샘플에서는 NetWkstaUserSetInfo 함수 호출을 사용하여 정보 수준 1101( WKSTA_USER_INFO_1101)을 지정하여 워크스테이션에 대한 사용자별 정보를 설정하는 방법을 보여 줍니다.

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

#include <stdio.h>
#include <windows.h> 
#include <lm.h>

int wmain(int argc, wchar_t *argv[])
{
   DWORD dwLevel = 1101;
   WKSTA_USER_INFO_1101 wui;
   NET_API_STATUS nStatus;

   if (argc != 2)
   {
      fwprintf(stderr, L"Usage: %s OtherDomains\n", argv[0]);
      exit(1);
   }
   //
   // Fill in the WKSTA_USER_INFO_1101 structure member.
   //
   wui.wkui1101_oth_domains = argv[1];
   //
   // Call the NetWkstaUserSetInfo function
   //  to change the list of domains browsed by
   //  the workstation; specify level 1101.
   //
   nStatus = NetWkstaUserSetInfo(NULL,
                                 dwLevel,
                                 (LPBYTE)&wui,
                                 NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fprintf(stderr, "Workstation user information has been changed\n");
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);

   return 0;
}

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	lmwksta.h(Lm.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll