RpcNsMgmtInqExpAge-Funktion (rpcnsi.h)
Die RpcNsMgmtInqExpAge-Funktion gibt das globale Ablaufalter für lokale Kopien von Name-Dienst-Daten zurück.
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 |
|---|---|
|
Der Aufruf war erfolgreich. |
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 |