Função de retorno de chamada pfnIsFileSupportedName (mssip.h)

  • Artigo

A função de retorno de chamada pfnIsFileSupportedName consulta os SIPs ( pacotes de interface do assunto ) listados no registro para determinar qual SIP manipula o tipo de arquivo.

Sintaxe

pfnIsFileSupportedName Pfnisfilesupportedname;

BOOL Pfnisfilesupportedname(
  [in]  WCHAR *pwszFileName,
  [out] GUID *pgSubject
)
{...}

Parâmetros

[in] pwszFileName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho absoluto para o arquivo a ser processado pelo SIP.

[out] pgSubject

O GUID que identifica o SIP que manipula o tipo de arquivo.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida; FALSE se a função falhar. Se a função falhar, chame a função GetLastError para determinar o motivo da falha.

Comentários

Se o SIP der suporte ao tipo de arquivo passado por hfile, a função retornará TRUE e definirá pgSubject para o GUID que identifica o SIP para manipular o tipo de arquivo.

Cada SIP implementa sua própria versão da função que determina se há suporte para o tipo de arquivo. O nome específico da função pode variar dependendo da implementação do SIP, mas a assinatura da função corresponderá à da estrutura SIP_ADD_NEWPROVIDER .

Os SIPs devem dar suporte a um conjunto limitado de tipos de arquivo e extensões de arquivo. A função fileSupportedName deve marcar que o arquivo fornecido corresponda a uma das extensões de arquivo compatíveis com o SIP. Por exemplo, o SIP WSH dá suporte apenas à seguinte lista de extensões de arquivo e verifica se o arquivo em validação é um membro da seguinte lista: .js, .jse, .vbe, .vbs ou .wsf.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [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 mssip.h

Confira também

pfnIsFileSupported