Share via

DsAddressToSiteNamesExA-Funktion (dsgetdc.h)

  • Artikel

Die DsAddressToSiteNamesEx-Funktion ruft die Standort- und Subnetznamen ab, die den angegebenen Adressen entsprechen.

Syntax

DSGETDCAPI DWORD DsAddressToSiteNamesExA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames,
  [out]          LPSTR           **SubnetNames
);

Parameter

[in, optional] ComputerName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Remoteservers angibt, der diese Funktion verarbeiten soll. Dieser Parameter muss der Name eines Domänencontrollers sein. Ein Nicht-Domänencontroller kann diese Funktion aufrufen, indem DsGetDcName aufgerufen wird, um den Domänencontroller zu finden.

[in] EntryCount

Enthält die Anzahl der Elemente im SocketAddresses-Array .

[in] SocketAddresses

Enthält ein Array von SOCKET_ADDRESS Strukturen, die die zu konvertierenden Adressen enthalten. Jede Adresse in diesem Array muss vom Typ AF_INET sein. EntryCount enthält die Anzahl der Elemente in diesem Array.

[out] SiteNames

Empfängt ein Array von NULL-beendeten Zeichenfolgenzeigern, die die Websitenamen für die Adressen enthalten. Jedes Element in diesem Array entspricht demselben Element im SocketAddresses-Array . Ein Element ist NULL , wenn die entsprechende Adresse keiner bekannten Website zugeordnet wird oder wenn der Adresseintrag nicht das richtige Format aufweist. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr benötigt wird, indem Er NetApiBufferFree aufruft.

[out] SubnetNames

Empfängt ein Array von NULL-beendeten Zeichenfolgenzeigern, die die Subnetznamen enthalten, die zum Ausführen der Zuordnungen von Adressen zu Standortnamen verwendet werden. Jedes Element in diesem Array entspricht demselben Element im SocketAddresses-Array . Ein Element ist NULL , wenn die zuordnung der entsprechenden Adresse zu Standortnamen nicht bestimmt wurde oder wenn kein Subnetz verwendet wurde, um die entsprechende Adresse zur Standortzuordnung durchzuführen. Letzteres ist der Fall, wenn es genau einen Standort im Unternehmen gibt, an dem keine Subnetzobjekte zugeordnet sind. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr benötigt wird, indem Er NetApiBufferFree aufruft.

Rückgabewert

Gibt NO_ERROR zurück, wenn erfolgreich oder andernfalls ein Win32- oder RPC-Fehler auftritt. Im Folgenden finden Sie mögliche Fehlercodes.

Hinweise

Hinweis

Der dsgetdc.h-Header definiert DsAddressToSiteNamesEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile dsgetdc.h
Bibliothek Netapi32.lib
DLL Netapi32.dll

Weitere Informationen

Verzeichnisdienstfunktionen

DsAddressToSiteNames

Dsgetdcname

NetApiBufferFree