Функция RpcNsMgmtSetExpAge (rpcnsi.h)

Функция RpcNsMgmtSetExpAge изменяет глобальный срок действия приложения для локальных копий данных службы имен.

Примечание Эта функция не поддерживается в операционных системах Windows Vista и более поздних версий.

 

Синтаксис

RPC_STATUS RpcNsMgmtSetExpAge(
  unsigned long ExpirationAge
);

Параметры

ExpirationAge

Указатель на срок действия по умолчанию в секундах. Это значение используется всеми операциями service-next. Срок действия 0 приводит к немедленному обновлению данных локальной службы имен.

Чтобы сбросить срок действия до значения по умолчанию, назначаемого RPC, равного двум часам, укажите значение RPC_C_NS_DEFAULT_EXP_AGE.

Возвращаемое значение

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.

 

Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.

 

Комментарии

Функция RpcNsMgmtSetExpAge изменяет глобальный срок действия приложения. Срок действия — это период времени, в течение которых локальная копия данных из атрибута name-service может существовать до того, как запрос из приложения для атрибута потребует обновления локальной копии. При запуске приложения в библиотеке времени выполнения RPC указывается срок действия по умолчанию в два часа. Значение по умолчанию является глобальным для приложения. Как правило, следует избегать использования RpcNsMgmtSetExpAge. Вместо этого следует полагаться на срок действия по умолчанию.

Срок действия используется следующими операциями указателя (которые считывают данные из атрибутов службы имен). Следующая операция обычно начинается с поиска локальной копии данных атрибута, запрашиваемой приложением. При отсутствии локальной копии следующая операция создает экземпляр со свежими данными атрибутов из базы данных службы имен. Если локальная копия уже существует, операция сравнивает ее фактический возраст с сроком действия, используемым приложением. Если фактический срок действия превышает срок действия, операция автоматически пытается обновить локальную копию с помощью новых данных атрибута. Если обновление невозможно, старые локальные данные остаются на месте и следующая операция завершается сбоем, возвращая код состояния RPC_S_NAME_SERVICE_UNAVAILABLE.

Установка небольшого значения срока действия приведет к тому, что последующие операции указателя часто обновляют локальные данные для любого атрибута name-service, запрошенного приложением. Например, если установить для срока действия значение 0, все последующие операции будут обновлять локальные данные для атрибута name-service, запрошенного приложением. Таким образом, установка небольшого срока действия может создать проблемы с производительностью приложения и увеличить сетевой трафик. Кроме того, если приложение использует удаленный сервер службы имен, небольшой срок действия может негативно повлиять на производительность сети для всех приложений.

Требования

Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rpcnsi.h (включая Rpc.h)
Библиотека	Rpcns4.lib
DLL	Rpcns4.dll

См. также раздел

RpcNsMgmtHandleSetExpAge