Compartilhar via


Método IFhTarget::GetStringProperty (fhcfg.h)

Recupera uma propriedade de cadeia de caracteres do destino de backup do Histórico de Arquivos representado por uma interface IFhTarget .

Observação

O IFhTarget foi preterido e pode ser alterado ou indisponível em versões futuras.

Sintaxe

HRESULT GetStringProperty(
  [in]  FH_TARGET_PROPERTY_TYPE PropertyType,
  [out] BSTR                    *PropertyValue
);

Parâmetros

[in] PropertyType

Especifica a propriedade string. Consulte a enumeração FH_TARGET_PROPERTY_TYPE para obter a lista de possíveis tipos de propriedade de cadeia de caracteres.

[out] PropertyValue

Esse parâmetro deve ser NULL na entrada. Na saída, ele recebe um ponteiro para uma cadeia de caracteres que contém a propriedade string. Essa cadeia de caracteres é alocada chamando SysAllocString. Você deve chamar SysFreeString para liberar a cadeia de caracteres quando ela não for mais necessária.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT , como um dos valores definidos no arquivo de cabeçalho FhErrors.h.

Comentários

A enumeração FH_TARGET_PROPERTY_TYPE define tipos de propriedade para propriedades de cadeia de caracteres e propriedades numéricas. No entanto, o método IFhTarget::GetStringProperty só pode ser usado para recuperar propriedades de cadeia de caracteres. As propriedades numéricas devem ser recuperadas chamando o método IFhTarget::GetNumericalProperty .

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fhcfg.h

Confira também

FH_TARGET_PROPERTY_TYPE

IFhTarget

IFhTarget::GetNumericalProperty