RpcNsMgmtInqExpAge-Funktion (rpcnsi.h)

Die RpcNsMgmtInqExpAge-Funktion gibt das globale Ablaufalter für lokale Kopien von Name-Dienst-Daten zurück.

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

 

Syntax

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

Parameter

ExpirationAge

Zeiger auf das Standardablaufalter in Sekunden. Dieser Wert wird von allen nächsten Vorgängen des Namensdiensts verwendet.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.

 

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

 

Hinweise

Die RpcNsMgmtInqExpAge-Funktion gibt das Von der Anwendung verwendete Ablaufalter zurück. Das Ablaufalter ist die Zeitspanne in Sekunden, in der eine lokale Kopie von Daten aus einem Name-Dienst-Attribut vorhanden sein kann, bevor eine Anforderung der Anwendung für das Attribut die lokale Kopie aktualisieren muss. Wenn die Ausführung einer Anwendung beginnt, gibt die RPC-Laufzeitbibliothek ein Standardablaufalter von zwei Stunden an. Der Standardwert ist global für die Anwendung.

Ein Ablaufalter wird von zeiger next-Vorgä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-Dienst-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.

Anwendungen sollten in der Regel nur das Standardablaufalter verwenden. In besonderen Fällen kann eine Anwendung jedoch ein vom Benutzer bereitgestelltes globales Ablaufalter durch die Standardeinstellung ersetzen, indem RpcNsMgmtSetExpAge aufgerufen wird. Die RpcNsMgmtInqExpAge-Funktion gibt das aktuelle globale Ablaufalter zurück, unabhängig davon, ob es sich um einen Standardwert oder einen vom Benutzer bereitgestellten Wert handelt. Eine Anwendung kann das globale Ablaufalter auch vorübergehend überschreiben, indem die RpcNsMgmtHandleSetExpAge-Funktion aufgerufen wird.

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 (rpc.h einschließen)
Bibliothek	Rpcns4.lib
DLL	Rpcns4.dll

Weitere Informationen

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge