RpcNsMgmtEntryInqIfIdsA-Funktion (rpcnsi.h)
Die RpcNsMgmtEntryInqIfIds-Funktion gibt die Liste der Schnittstellen zurück, die in einen Namensdienst–Datenbankeintrag exportiert wurden. Außerdem wird ein Schnittstellenidentifikationsvektor zurückgegeben, der die Schnittstellen von Bindungshandles enthält, die von einem Server an EntryName exportiert werden. Diese Funktion verwendet ein Ablaufalter von 0, was zu einer sofortigen Aktualisierung der lokalen Kopie der Name-Dienst-Daten führt.
Syntax
RPC_STATUS RpcNsMgmtEntryInqIfIdsA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_ID_VECTOR **IfIdVec
);
Parameter
EntryNameSyntax
Syntax von EntryName.
Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie den Wert RPC_C_NS_SYNTAX_DEFAULT an.
EntryName
Zeiger auf den Namen dienst–Datenbankeintragsnamen, für den ein Schnittstellenidentifikationsvektor zurückgegeben wird.
IfIdVec
Gibt eine Adresse eines Zeigers auf den Schnittstellenidentifikationsvektor zurück.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Namenssyntax ist ungültig. |
|
Die Namenssyntax wird nicht unterstützt. |
|
Der Name ist unvollständig. |
|
Der Name-Dienst-Eintrag wurde nicht gefunden. |
|
Der Namensdienst ist nicht verfügbar. |
Hinweise
Die RpcNsMgmtEntryInqIfIds-Funktion gibt einen Schnittstellenidentifikationsvektor zurück, der die Schnittstellen von Bindungshandles enthält, die von einem Server an EntryName exportiert werden. Diese Funktion verwendet ein Ablaufalter von 0, was zu einer sofortigen Aktualisierung der lokalen Kopie der Name-Dienst-Daten führt. Die aufrufende Anwendung ist für das Aufrufen der RpcIfIdVectorFree-Funktion verantwortlich, um den vom Vektor verwendeten Arbeitsspeicher freizugeben.
Hinweis
Der rpcnsi.h-Header definiert RpcNsMgmtEntryInqIfIds als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcnsi.h (include Rpc.h) |
| Bibliothek | Rpcns4.lib |
| DLL | Rpcns4.dll |