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 |
|
| Biblioteca |
|
| DLL |
|
| Nomes Unicode e ANSI |
DeletePrinterDataExW (Unicode) e DeletePrinterDataExA (ANSI) |