Compartilhar via


função PifMgr_SetProperties (shlobj_core.h)

[PifMgr_SetProperties está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Atribui valores a um bloco de dados de um arquivo .pif.

Sintaxe

int PifMgr_SetProperties(
  [in, optional] HANDLE     hProps,
  [in, optional] PCSTR      pszGroup,
  [in]           const void *lpProps,
                 int        cbProps,
                 UINT       flOpt
);

Parâmetros

[in, optional] hProps

Tipo: HANDLE

Um identificador para as propriedades do aplicativo. Esse parâmetro deve ser definido como o valor retornado por PifMgr_OpenProperties.

[in, optional] pszGroup

Tipo: PCSTR

Uma cadeia de caracteres ANSI terminada em nulo que contém o nome do grupo de propriedades. Pode ser um dos seguintes ou qualquer outro nome que corresponda a uma extensão .pif válida.

"WINDOWS 286 3.0"

"WINDOWS 386 3.0"

"WINDOWS VMM 4.0"

"WINDOWS NT 3.1"

"WINDOWS NT 4.0"

[in] lpProps

Tipo: const void*

Um buffer de registro do grupo de propriedades que contém os dados.

cbProps

Tipo: int

O tamanho do buffer, em bytes, apontado por lpProps.

flOpt

Tipo: UINT

Sempre SETPROPS_NONE.

Retornar valor

Tipo: int

Retorna a quantidade de informações transferidas, em bytes. Retornará zero se o grupo não puder ser encontrado ou ocorrer um erro.

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 shlobj_core.h
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)

Confira também

PifMgr_GetProperties