Freigeben über


NetEnumerateComputerNames-Funktion (lmjoin.h)

Die NetEnumerateComputerNames-Funktion listet Namen für den angegebenen Computer auf.

Syntax

NET_API_STATUS NET_API_FUNCTION NetEnumerateComputerNames(
  [in, optional] LPCWSTR                Server,
  [in]           NET_COMPUTER_NAME_TYPE NameType,
  [in]           ULONG                  Reserved,
  [out]          PDWORD                 EntryCount,
  [out]          LPWSTR                 **ComputerNames
);

Parameter

[in, optional] Server

Ein Zeiger auf eine konstante Zeichenfolge, die den Namen des Computers angibt, auf dem diese Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] NameType

Der Typ des abgefragten Namens. Dieser Member kann einer der folgenden Werte sein, die in der NET_COMPUTER_NAME_TYPE-Enumeration definiert sind, die in der Headerdatei Lmjoin.h definiert ist.

Wert Bedeutung
NetPrimaryComputerName
Der Name des primären Computers.
NetAlternateComputerNames
Alternative Computernamen.
NetAllComputerNames
Alle Computernamen.
NetComputerNameTypeMax
Gibt das Ende des Bereichs an, der die möglichen Werte für den Typ des abgefragten Namens angibt.

[in] Reserved

Für die zukünftige Verwendung reserviert. Dieser Parameter sollte NULL sein.

[out] EntryCount

Ein Zeiger auf einen DWORD-Wert, der die Anzahl der Namen zurückgibt, die im Puffer zurückgegeben werden, auf den der ComputerNames-Parameter verweist, wenn die Funktion erfolgreich ist.

[out] ComputerNames

Ein Zeiger auf ein Array von Zeigern auf Namen. Wenn der Funktionsaufruf erfolgreich ist, gibt dieser Parameter die Computernamen zurück, die dem im Parameter NameType angegebenen Computertypnamen entsprechen.

Wenn die Anwendung dieses Array nicht mehr benötigt, sollte dieser Puffer durch Aufrufen der NetApiBufferFree-Funktion freigegeben werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes oder einer der Systemfehlercodes sein.

Rückgabecode Beschreibung
ERROR_ACCESS_DENIED
Der Zugriff wird verweigert. Dieser Fehler wird zurückgegeben, wenn der Aufrufer kein Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer war.
ERROR_INVALID_PARAMETER
Ein Parameter ist falsch.
ERROR_NOT_ENOUGH_MEMORY
Für die Verarbeitung dieses Befehls steht nicht genügend Arbeitsspeicher zur Verfügung.
ERROR_NOT_SUPPORTED
Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der im Serverparameter angegebene Zielcomputer, auf dem diese Funktion ausgeführt wird, unter Windows 2000 und früher ausgeführt wird.
NERR_WkstaNotStarted
Der Arbeitsstationsdienst wurde nicht gestartet.
RPC_S_CALL_IN_PROGRESS
Für diesen Thread wird bereits ein Remoteprozeduraufruf ausgeführt.
RPC_S_PROTSEQ_NOT_SUPPORTED
Die Protokollsequenz des Remoteprozeduraufrufs wird nicht unterstützt.

Hinweise

Die NetEnumerateComputerNames-Funktion wird unter Windows Vista und höher unterstützt.

Die NetEnumerateComputerNames-Funktion wird verwendet, um die Namen anzufordern, die ein Computer derzeit konfiguriert hat.

Die NetEnumerateComputerNames-Funktion erfordert, dass der Aufrufer Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile lmjoin.h (lm.h einschließen)
Bibliothek Netapi32.lib
DLL Netapi32.dll

Weitere Informationen

NetAddAlternateComputerName

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx