PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 función de devolución de llamada (netfw.h)
Tipo de puntero de función del punto de entrada en el servicio al que se llama para enumerar las direcciones de palabras clave dinámicas por tipo. Puede solicitar un subconjunto determinado de objetos en función de las marcas de enumeración pasadas.
Nota
Un tipo de puntero para esta función gratuita se publica a través NetFw.hde , pero no se publica una biblioteca de vínculos estáticos. Use el patrónGetProcAddressloadLibraryExW/ para llamar a esta función.
Al llamar a GetProcAddress, pase un identificador al módulo firewallapi.dll y pase FWEnumDynamicKeywordAddressesByType0 como argumento lpProcName .
Para obtener más información y ejemplos de código, consulte Palabras clave dinámicas del firewall.
Sintaxis
PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;
DWORD PfnFwenumdynamickeywordaddressesbytype0(
DWORD flags,
PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}
Parámetros
flags
Tipo: DWORD
Con el valor FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE enumerará todos los objetos que tengan establecida la marca FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE .
Con el valor FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE enumerará todos los objetos que tienen la marca FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEno establecida.
El uso del valor FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE enumerará todos los objetos.
dynamicKeywordAddressData
Tipo: _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*
Dirección de un puntero a un objeto de dirección de palabra clave dinámica, que contendrá una lista vinculada de objetos devueltos. Debe liberar esta dirección llamando a FWFreeDynamicKeywordAddressData0.
Valor devuelto
Tipo: DWORD
Si la función se realiza correctamente, devuelve ERROR_SUCCESS. De lo contrario, devuelve uno de los valores siguientes.
| Valor devuelto | Descripción |
|---|---|
| ERROR_INVALID_PARAMETER | Se pasó un valor cero para el parámetro flags . |
Comentarios
Debe liberar la dirección del primer objeto devuelto en la lista (el encabezado de la lista) llamando a FWFreeDynamicKeywordAddressData0.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | compilación 20348 de Windows 10 |
| Servidor mínimo compatible | compilación 20348 de Windows 10 |
| Plataforma de destino | Windows |
| Encabezado | netfw.h |
| Archivo DLL | firewallapi.dll |