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
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".
Ejemplos
Ejemplo 1:
%DEFINE RegistryTable = %TABLE(ALL) @DTWR_LISTSUB("URLLIST", RegistryTable)