RpcNsMgmtInqExpAge 函式 (rpcnsi.h)
RpcNsMgmtInqExpAge 函式會傳回名稱服務數據本地副本的全域到期時間。
注意 Windows Vista 和更新版本的作業系統不支援此函式。
語法
RPC_STATUS RpcNsMgmtInqExpAge(
unsigned long *ExpirationAge
);
參數
ExpirationAge
默認到期時間的指標，以秒為單位。 這個值會由所有名稱服務下一個作業使用。
傳回值
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
備註
RpcNsMgmtInqExpAge 函式會傳回應用程式所使用的到期時間。 到期期限是來自名稱服務屬性的本機數據複本可能需要數秒的時間量，才能從應用程式要求屬性需要更新本機複本。 當應用程式開始執行時，RPC 運行時間連結庫會指定預設到期時間為兩小時。 預設值為應用程式的全域。
指標下一個作業會使用到期期限， (從名稱服務屬性讀取數據) 。 下一個作業通常會從尋找應用程式所要求的屬性數據的本機複本開始。 如果沒有本機複本，下一個作業會從 name-service 資料庫建立一個具有全新屬性數據的作業。 如果本機複本已經存在，作業會比較其實際存留期與應用程式所使用的到期時間。 如果實際存留期超過到期期限，則作業會自動嘗試以全新的屬性數據更新本機複本。 如果無法更新，舊的本機數據仍會就地運作，而下一個作業會失敗。
應用程式通常應該只使用預設到期日。 不過，針對特殊案例，應用程式可以藉由呼叫 RpcNsMgmtSetExpAge 來取代使用者提供的全域到期期限。 RpcNsMgmtInqExpAge 函式會傳回目前的全域到期期限，無論是預設或使用者提供的值。 應用程式也可以藉由呼叫 RpcNsMgmtHandleSetExpAge 函式，暫時覆寫全域到期日。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcnsi.h (包含 Rpc.h) |
| 程式庫 | Rpcns4.lib |
| Dll | Rpcns4.dll |