DsAddressToSiteNamesExA-Funktion (dsgetdc.h)
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 |