DsAddressToSiteNamesExA-Funktion (dsgetdc.h)
Die funktion DsAddressToSiteNamesEx 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
Zeigen Sie auf eine mit Null beendete 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 Arrays.
[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_INETsein. EntryCount- enthält die Anzahl der Elemente in diesem Array.
[out] SiteNames
Empfängt ein Array mit null-beendeten Zeichenfolgenzeigern, die die Websitenamen für die Adressen enthalten. Jedes Element in diesem Array entspricht demselben Element im SocketAddresses Arrays. Ein Element ist NULL-, wenn die entsprechende Adresse keiner bekannten Website zugeordnet ist oder der Adresseintrag nicht das richtige Formular aufweist. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr erforderlich ist, indem NetApiBufferFreeaufgerufen wird.
[out] SubnetNames
Empfängt ein Array von null-beendeten Zeichenfolgenzeigern, die die Subnetznamen enthalten, die zum Ausführen der Adresse zu Standortnamenzuordnungen verwendet werden. Jedes Element in diesem Array entspricht demselben Element im SocketAddresses Arrays. Ein Element ist NULL-, wenn die entsprechende Adresse zur Standortnamenzuordnung nicht bestimmt wurde oder ob kein Subnetz zum Ausführen der entsprechenden Adresse zur Standortzuordnung verwendet wurde. Letzteres ist der Fall, wenn genau ein Standort im Unternehmen vorhanden ist, dem keine Subnetzobjekte zugeordnet sind. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr erforderlich ist, indem NetApiBufferFreeaufgerufen wird.
Rückgabewert
Gibt NO_ERROR zurück, wenn ein Win32- oder RPC-Fehler andernfalls erfolgreich war. Im Folgenden finden Sie mögliche Fehlercodes.
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | dsgetdc.h |
| Library | Netapi32.lib |
| DLL- | Netapi32.dll |