Compartilhar via


Método IFileSystemImage::CalculateDiscIdentifier (imapi2fs.h)

Recupera uma cadeia de caracteres que identifica um disco e as sessões gravadas no disco.

Sintaxe

HRESULT CalculateDiscIdentifier(
  [out] BSTR *discIdentifier
);

Parâmetros

[out] discIdentifier

Cadeia de caracteres que contém uma assinatura que identifica o disco e as sessões nele. Não há garantia de que essa cadeia de caracteres seja exclusiva entre os discos.

Valor retornado

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_POINTER
O ponteiro não é válido.

Valor: 0x80004003

IMAPI_E_MULTISESSION_NOT_SET
A propriedade MultisessionInterfaces deve ser definida antes de chamar esse método.

Valor: 0xC0AAB15D

Comentários

Ao colocar sessões em camadas em um disco, a assinatura atua como uma chave que o cliente pode usar para garantir a ordem da sessão e para distinguir sessões no disco de imagens de sessão que serão colocadas no disco.

Você deve chamar IFileSystemImage::p ut_MultisessionInterfaces antes de chamar CalculateDiscIdentifier.

Requisitos

   
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IFileSystemImage