Identificadores de retomada de enumeração

Os identificadores de retomada de enumeração são identificadores para a chave de retomada real contida nos dados da instância da função. Isso é necessário para segurança, interoperabilidade e para simplificar o código do chamador para a função.

Se um NULL for passado para o ponteiro para o identificador de retomada, nenhum identificador será armazenado e a pesquisa de enumeração não poderá continuar. Isso é útil nos casos em que o aplicativo não deseja enumerar todos os itens.

Se um erro for retornado de uma chamada de enumeração, o identificador de retomada deverá ser tratado como inválido e não será usado para chamadas de enumeração subsequentes. Quando isso ocorre, você deve reiniciar a enumeração desde o início.