Função RpcNsMgmtSetExpAge (rpcnsi.h)
A função RpcNsMgmtSetExpAge modifica a idade de expiração global do aplicativo para cópias locais de dados de name-service.
Sintaxe
RPC_STATUS RpcNsMgmtSetExpAge(
unsigned long ExpirationAge
);
Parâmetros
ExpirationAge
Ponteiro para a idade de expiração padrão, em segundos. Esse valor é usado por todas as operações de serviço de nome – próximas. Uma idade de expiração de 0 causa uma atualização imediata dos dados de name-service local.
Para redefinir a idade de expiração para um valor padrão atribuído por RPC de duas horas, especifique um valor de RPC_C_NS_DEFAULT_EXP_AGE.
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
O serviço de nome está indisponível. |
Comentários
A função RpcNsMgmtSetExpAge modifica a idade de expiração global de um aplicativo. A idade de expiração é a quantidade de tempo 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 duração de expiração padrão de duas horas. O padrão é global para o aplicativo. Normalmente, você deve evitar o uso de RpcNsMgmtSetExpAge. Em vez disso, você deve confiar na idade de expiração padrão.
Uma idade de expiração é usada pelas próximas operações de ponteiro (que leem dados de atributos de 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 dados de atributo atualizados 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 dados de atributo atualizados. Se a atualização for impossível, os dados locais antigos permanecerão em vigor e a próxima operação falhará, retornando o código RPC_S_NAME_SERVICE_UNAVAILABLE status.
Definir a idade de expiração como um valor pequeno faz com que as próximas operações ponteiro atualizem com frequência os dados locais para qualquer atributo name-service solicitado pelo aplicativo. Por exemplo, definir a idade de expiração como 0 força todas as próximas operações a atualizar dados locais para o atributo name-service solicitado pelo aplicativo. Portanto, definir pequenas idades de expiração pode criar problemas de desempenho para seu aplicativo e aumentar o tráfego de rede. Além disso, se o aplicativo estiver usando um servidor de serviço de nome remoto, uma pequena idade de expiração poderá afetar negativamente o desempenho da rede para todos os aplicativos.
Requisitos
| 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 |