Função RpcNsMgmtInqExpAge (rpcnsi.h)

  • Artigo

A função RpcNsMgmtInqExpAge retorna a idade de expiração global para cópias locais de dados name-service.

Nota Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.
 

Sintaxe

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

Parâmetros

ExpirationAge

Ponteiro para a idade de expiração padrão, em segundos. Esse valor é usado por todas as próximas operações do serviço de nome.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

A função RpcNsMgmtInqExpAge retorna a idade de expiração que o aplicativo está usando. A idade de expiração é a quantidade de tempo em segundos que uma cópia local de dados de um atributo name-service pode existir antes que uma solicitação do aplicativo para o atributo exija a atualização da cópia local. Quando um aplicativo começa a ser executado, a biblioteca de tempo de execução RPC especifica uma idade de expiração padrão de duas horas. O padrão é global para o aplicativo.

Uma idade de expiração é usada pelas próximas operações de Ponteiro (que leem dados de atributos name-service). Uma próxima operação normalmente começa procurando uma cópia local dos dados de atributo que estão sendo solicitados por um aplicativo. Na ausência de uma cópia local, a próxima operação cria uma com novos dados de atributo do banco de dados name-service. Se já existir uma cópia local, a operação comparará sua idade real com a idade de expiração que está sendo usada pelo aplicativo. Se a idade real exceder a idade de expiração, a operação tentará atualizar automaticamente a cópia local com novos dados de atributo. Se a atualização for impossível, os dados locais antigos permanecerão em vigor e a próxima operação falhará.

Normalmente, os aplicativos devem usar apenas a idade de expiração padrão. No entanto, para casos especiais, um aplicativo pode substituir uma idade de expiração global fornecida pelo usuário pelo padrão chamando RpcNsMgmtSetExpAge. A função RpcNsMgmtInqExpAge retorna a idade de expiração global atual, seja um valor padrão ou fornecido pelo usuário. Um aplicativo também pode substituir a idade de expiração global temporariamente chamando a função RpcNsMgmtHandleSetExpAge .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcnsi.h (inclua Rpc.h)
Biblioteca Rpcns4.lib
DLL Rpcns4.dll

Confira também

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge