Manual de consulta

DTWR_LISTSUB


AIX HP-UX Linux OS/2 OS/390 OS/400 PTX SUN Win NT
X

X



X

Finalidad

Lista las entradas de subclave inmediatas de un registro Web.

Formato

@DTWR_LISTSUB(registro, Tablaregistro)

Parámetros

Tabla 213. Parámetro de DTWR_LISTSUB
Tipo de datos Parámetro Uso Descripción
serie registro IN El nombre del registro que ha de listarse.
tabla Tablaregistro OUT El nombre de la variable de tabla en la que van a colocarse las entradas de registro.

Códigos de retorno

Tabla 214. Códigos de retorno de DTWR_LISTSUB
Código de retorno Explicación
-1001 El servidor no ha podido procesar una petición de Net.Data para asignar memoria.
1001 Un parámetro de entrada contenía un valor NULL.
1002 Un parámetro de entrada contenía un valor de serie que consistía en el carácter de terminación nulo.
1003 Se ha transmitido un número incorrecto de parámetros en una llamada de función.
1005 Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente.
1006 Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida.
1007 Un parámetro contiene un valor que no es válido.
3005 Una función incorporada de registro Web no ha podido utilizar el registro especificado porque no se puede encontrar.
3007 Una función incorporada de registro Web no ha podido completar la operación especificada porque el peticionario no tiene la autorización adecuada para el registro especificado.

Notas de utilización

  1. DTWR_LISTSUB devuelve información sobre las entradas de registro de un parámetro de tabla OUT que ha transmitido el usuario. La variable de tabla se ha definido en la macro antes de transmitirse como parámetro a la operación de registro LISTSUB.

    Si el usuario ha definido la variable de tabla utilizando la opción ALL para el número máximo de filas para la tabla, esta operación lista todas las entradas de registro disponibles en la tabla, una por cada fila de tabla. Por otro lado, si el usuario ha especificado un valor X para el número máximo de filas de tabla, en el caso de que haya más entradas X en el registro especificado, sólo se listan las primeras entradas X y se envía de nuevo un código de error para indicar que sólo puede hacerse un listado parcial ya que no hay suficientes filas de tabla disponibles para listar entradas adicionales. Se listan todas las entradas de registro en el caso de que el valor X supere el número de entradas disponibles en el registro especificado. El número de columnas de la tabla siempre es uno.

    La cabecera de columna para la tabla se establece en "REGISTRY_SUBKEY".

  2. Esta función sólo es válida en los sistemas operativos que son compatibles con Registros del sistema Windows 95.

Ejemplos

Ejemplo 1:

%DEFINE RegistryTable =
%TABLE(ALL)
 
@DTWR_LISTSUB("URLLIST", RegistryTable)


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]