Compartilhar via


Função DeletePrinterDataEx

A função DeletePrinterDataEx exclui um valor especificado dos dados de configuração de uma impressora. Os dados de configuração de uma impressora consistem em um conjunto de valores nomeados e tipado armazenados em uma hierarquia de chaves do Registro. A função exclui um valor especificado em uma chave especificada.

Assim como a função DeletePrinterData , DeletePrinterDataEx pode excluir valores armazenados pela função SetPrinterData . Além disso, DeletePrinterDataEx pode excluir valores armazenados em uma chave especificada pela função SetPrinterDataEx .

Sintaxe

DWORD DeletePrinterDataEx(
  _In_ HANDLE  hPrinter,
  _In_ LPCTSTR pKeyName,
  _In_ LPCTSTR pValueName
);

Parâmetros

hPrinter [in]

Um identificador para a impressora para a qual a função exclui um valor. Use a função OpenPrinter ou AddPrinter para recuperar um identificador de impressora.

pKeyName [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica a chave que contém o valor a ser excluído. Use o caractere de barra invertida ( \ ) como um delimitador para especificar um caminho que tenha uma ou mais subchaves.

Se pKeyName for NULL ou uma cadeia de caracteres vazia, DeletePrinterDataEx retornará ERROR_INVALID_PARAMETER.

pValueName [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do valor a ser excluído.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

Observação

Essa é uma função de bloqueio ou síncrona e pode não retornar imediatamente. A rapidez com que essa função retorna depende de fatores de tempo de execução, como status de rede, configuração do servidor de impressão e fatores de implementação de driver de impressora que são difíceis de prever ao escrever um aplicativo. Chamar essa função de um thread que gerencia a interação com a interface do usuário pode fazer com que o aplicativo pareça não responder.

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]
Cabeçalho
Winspool.h (inclua Windows.h)
Biblioteca
Winspool.lib
DLL
Winspool.drv
Nomes Unicode e ANSI
DeletePrinterDataExW (Unicode) e DeletePrinterDataExA (ANSI)

Confira também

Impressão

Funções da API do Spooler de impressão

DeletePrinterKey

EnumPrinterDataEx

EnumPrinterKey

GetPrinterDataEx

OpenPrinter

SetPrinterDataEx