RpcNsMgmtSetExpAge 函式 (rpcnsi.h)
RpcNsMgmtSetExpAge函式會針對名稱服務資料的本機複本修改應用程式的全域到期時間。
語法
RPC_STATUS RpcNsMgmtSetExpAge(
unsigned long ExpirationAge
);
參數
ExpirationAge
預設到期時間的指標，以秒為單位。 這個值會由所有名稱服務-下一個作業使用。 到期期限為 0 會導致立即更新本機名稱服務資料。
若要將到期期限重設為兩小時的 RPC 指派預設值，請指定值RPC_C_NS_DEFAULT_EXP_AGE。
傳回值
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
|
名稱服務無法使用。 |
備註
RpcNsMgmtSetExpAge函式會修改應用程式的全域到期時間。 到期期限是來自名稱服務屬性的本機資料複本可以存在的時間量，然後屬性的應用程式要求需要更新本機複本。 當應用程式開始執行時，RPC 執行時間程式庫會指定預設到期時間為兩小時。 預設值為應用程式的全域。 一般而言，您應該避免使用 RpcNsMgmtSetExpAge。 相反地，您應該依賴預設到期期限。
指標下一個作業會使用到期期限， (從名稱服務屬性讀取資料) 。 下一個作業通常會從尋找應用程式所要求的屬性資料的本機複本開始。 如果沒有本機複本，下一個作業會從 name-service 資料庫建立一個具有全新屬性資料的作業。 如果本機複本已經存在，作業會比較其實際存留期與應用程式所使用的到期時間。 如果實際存留期超過到期期限，則作業會自動嘗試以全新的屬性資料更新本機複本。 如果無法更新，舊的本機資料仍會就地運作，而下一個作業會失敗，並傳回RPC_S_NAME_SERVICE_UNAVAILABLE狀態碼。
將到期期限設定為較小的值，會導致指標下一個作業經常更新應用程式所要求的任何名稱服務屬性的本機資料。 例如，將到期期限設定為 0 會強制所有下一個作業更新應用程式所要求的名稱服務屬性的本機資料。 因此，設定小型到期日可能會為您的應用程式建立效能問題，並增加網路流量。 此外，如果您的應用程式使用遠端名稱服務伺服器，小型到期期限可能會對所有應用程式的網路效能造成負面影響。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcnsi.h (包含 Rpc.h) |
| 程式庫 | Rpcns4.lib |
| Dll | Rpcns4.dll |