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

Статья
03/15/2023

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

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

Синтаксис

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

Параметры

ExpirationAge

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

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.

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

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

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

Приложения обычно должны использовать только срок действия по умолчанию. Однако в особых случаях приложение может заменить предоставленный пользователем глобальный срок действия по умолчанию, вызвав RpcNsMgmtSetExpAge. Функция RpcNsMgmtInqExpAge возвращает текущий глобальный срок действия, будь то значение по умолчанию или предоставленное пользователем. Приложение также может временно переопределить глобальный срок действия, вызвав функцию RpcNsMgmtHandleSetExpAge .

Требования

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

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

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge

Поделиться через