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

此參數必須設定為零。

[in] level

指定資料的資訊層級。此參數可以是下列其中一個值。

值	意義
1	指定工作站的相關資訊，包括目前使用者的名稱和工作站所存取的網域。 buf參數指向WKSTA_USER_INFO_1結構。
1101	指定工作站所流覽的網域。 buf參數指向WKSTA_USER_INFO_1101結構。

[in] buf

指定資料的緩衝區指標。此資料的格式取決於 level 參數的值。如需詳細資訊，請參閱網路管理功能緩衝區。

[out] parm_err

值指標，這個值會接收造成ERROR_INVALID_PARAMETER錯誤之第一個參數的索引。如果此參數為 Null，則不會在錯誤時傳回索引。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	描述
ERROR_INVALID_LEVEL	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_，且其格式是由 level 參數所指定。) 下表列出可在 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