Доступные версии документации

Дать идентификатор пользователя

Назначение
 

Команда FUSR предназначена для получения идентификатора указанного пользователя.

Параметры вызова

inter(CBL, VarBuf, NULL, [CondBuf], RowBuf);

Входные данные

Входными данными являются:

  • контрольный блок CBL;

  • буфер описания параметров VarBuf.

В контрольном блоке должны быть заполнены поля:

Имя поля Значение
NumChan Номер канала
Command "FUSR"
LnBufRow Длина буфера выборки данных
Node Имя ЛИНТЕР-сервера

Буфер описания параметров VarBuf должен содержать имя интересующего пользователя. В отличие от употребления имени пользователя при его идентификации (например, в команде OPEN), в данной команде оно не проходит синтаксического разбора, его символы воспринимаются в том виде, в котором заданы, без изменения регистра. Поэтому в конкретном случае любые двойные кавычки (если они используются в имени пользователя) представляют самих себя и не являются элементом синтаксической конструкции. Например, приведенные ниже имена пользователей (как они представлены в VarBuf) являются различными именами:

Иванов, ИВАНОВ, "ИВАНОВ", Smit, SMIT, "Smit"

Примечание

Если длина имени пользователя меньше MAX_ID_LEN символов, то имя пользователя должно быть дополнено справа пробелами до MAX_ID_LEN символов.

Выходные данные

Выходными данными являются:

  • контрольный блок CBL;

  • буфер выборки данных RowBuf.

В контрольном блоке будут возвращены:

Имя поля Значение
CodErr Код завершения запроса к СУБД ЛИНТЕР
LnBufRow Фактическая длина буфера выборки данных
SysErr Код состояния ОС

Информация в буфере выборки данных RowBuf будет представлена в следующем виде:

L_LONG User_Id; /* Идентификатор пользователя */
Описание

По этой команде СУБД сначала просматривает очередь пользователей в оперативной памяти ядра для поиска указанного имени. Если нужного пользователя не найдено, поиск продолжается в таблице пользователей $$$USR.

Коды завершения
Код Описание
NORMAL Нормальное завершение
SMALLBUFKOR Недостаточный размер буфера выборки данных
EORR Указанный пользователь не найден
Пример формирования команды
#include <string.h>
#include <stdlib.h>
#include "inter.h"


L_LONG LinterFUSR(TCBL * pCBL, L_CHAR * User, L_LONG * pUser_ID)
  {
  memcpy(pCBL->Command, "FUSR", 4);
  pCBL->LnBufRow = sizeof(L_LONG);
  pCBL->PrzExe &= ~Q_ASYNC;
  inter(pCBL, User, NULL, NULL, pUser_ID);
  return pCBL->CodErr;
  }
Пример использования команды
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "inter.h"
#include "exlib.h"


#ifndef WINCE
int    main()
#else
int    exfusr()
#endif
  {
  TCBL    CBLconnect;
  L_CHAR    Name_Pass[] = "SYSTEM/MANAGER";
  L_CHAR    Node[] = "        ";
  L_WORD    Priority = 0;
  L_LONG  PrzExe = M_EXCLUSIVE | Q_ENCODE | M_BINARY;
  L_LONG  Err;
  L_LONG  ID;
  L_CHAR    User[] = "SYSTEM";

  memset(&CBLconnect,0,sizeof(TCBL));
  Err = LinterOPEN(&CBLconnect, Name_Pass, Node, Priority, PrzExe);
  if (Err != NORMAL)
    PrintError(&CBLconnect);
  printf("Connect to RDBMS Linter\n");

  Err = LinterFUSR(&CBLconnect, User, &ID);
  if (Err != NORMAL)
    PrintError(&CBLconnect);
  printf("FUSR:\n");
  printf("User=%s,ID=%ld\n", User, ID);

  printf("End Example\n");

  return 0;
  }
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter