RpcNsMgmtSetExpAge-Funktion (rpcnsi.h)

Die RpcNsMgmtSetExpAge-Funktion ändert das globale Ablaufalter der Anwendung für lokale Kopien von Name-Dienst-Daten.

Hinweis Diese Funktion wird unter Windows Vista und höheren Betriebssystemen nicht unterstützt.

 

Syntax

RPC_STATUS RpcNsMgmtSetExpAge(
  unsigned long ExpirationAge
);

Parameter

ExpirationAge

Zeiger auf das Standardablaufalter in Sekunden. Dieser Wert wird von allen Namensdienst-Nächsten-Vorgängen verwendet. Ein Ablaufalter von 0 bewirkt eine sofortige Aktualisierung der lokalen Name-Dienst-Daten.

Um das Ablaufalter auf einen RPC-zugewiesenen Standardwert von zwei Stunden zurückzusetzen, geben Sie den Wert RPC_C_NS_DEFAULT_EXP_AGE an.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.

 

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

 

Hinweise

Die RpcNsMgmtSetExpAge-Funktion ändert das globale Ablaufalter einer Anwendung. Das Ablaufalter ist die Zeitspanne, die eine lokale Kopie von Daten aus einem name-service-Attribut vorhanden sein kann, bevor eine Anforderung der Anwendung für das Attribut eine Aktualisierung der lokalen Kopie erfordert. Wenn eine Anwendung mit der Ausführung beginnt, gibt die RPC-Laufzeitbibliothek ein Standardablaufalter von zwei Stunden an. Der Standardwert ist global für die Anwendung. In der Regel sollten Sie die Verwendung von RpcNsMgmtSetExpAge vermeiden. Stattdessen sollten Sie sich auf das Standardablaufalter verlassen.

Ein Ablaufalter wird von nächsten Zeigervorgängen (die Daten aus Name-Dienst-Attributen lesen) verwendet. Ein nächster Vorgang beginnt in der Regel mit der Suche nach einer lokalen Kopie der Attributdaten, die von einer Anwendung angefordert werden. Wenn keine lokale Kopie vorhanden ist, wird beim nächsten Vorgang eine mit neuen Attributdaten aus der name-service-Datenbank erstellt. Wenn bereits eine lokale Kopie vorhanden ist, vergleicht der Vorgang sein tatsächliches Alter mit dem Ablaufalter, das von der Anwendung verwendet wird. Wenn das tatsächliche Alter das Ablaufalter überschreitet, versucht der Vorgang automatisch, die lokale Kopie mit neuen Attributdaten zu aktualisieren. Wenn die Aktualisierung nicht möglich ist, bleiben die alten lokalen Daten vorhanden, und der nächste Vorgang schlägt fehl, wodurch der RPC_S_NAME_SERVICE_UNAVAILABLE status Code zurückgegeben wird.

Wenn Sie das Ablaufalter auf einen kleinen Wert festlegen, werden die nächsten Zeigervorgänge häufig lokale Daten für ein beliebiges name-service-Attribut aktualisieren, das von Ihrer Anwendung angefordert wird. Wenn Sie beispielsweise das Ablaufalter auf 0 festlegen, müssen alle nächsten Vorgänge lokale Daten für das von Ihrer Anwendung angeforderte Attribut name-service aktualisieren. Daher kann das Festlegen kleiner Ablaufalters Leistungsprobleme für Ihre Anwendung verursachen und den Netzwerkdatenverkehr erhöhen. Außerdem kann sich ein geringes Ablaufalter negativ auf die Netzwerkleistung aller Anwendungen auswirken, wenn Ihre Anwendung einen Remotename-Dienst-Server verwendet.

Anforderungen

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

Weitere Informationen

RpcNsMgmtHandleSetExpAge