다음 함수는 엔터티(개체)에 대해 작동합니다.
마지막 쿼리 명령을 통해 찾은 엔터티의 수를 반환합니다.
N번째 엔터티에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
목록의 첫 번째 엔터티에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
목록의 다음 엔터티에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
엔터티 목록의 지정된 개체에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
엔터티 핸들이 가리키는 개체의 이름을 반환합니다.
엔터티 핸들이 가리키는 개체의 클래스 이름을 반환합니다.
다음 함수는 속성에 대해 작동합니다.
엔터티에 사용 가능한 속성의 수를 반환합니다.
엔터티의 N번째 속성에 대한 LCA_QPROP_H 유형의 속성 핸들을 반환합니다.
엔터티의 첫 번째 속성에 대한 LCA_QPROP_H 유형의 속성 핸들을 반환합니다.
엔터티의 다음 속성에 대한 LCA_QPROP_H 유형의 속성 핸들을 반환합니다.
엔터티의 지정된 속성에 대한 LCA_QPROP_H 유형의 속성 핸들을 반환합니다.
속성 핸들이 가리키는 속성의 이름을 반환합니다.
속성의 크기(바이트)를 반환합니다.
속성의 유형을 반환합니다.
속성 값의 수를 반환합니다.
속성의 속성 값 목록을 반환합니다.
단일 속성의 N번째 값을 반환합니다.
속성 값의 목록에서 첫 번째 값을 반환합니다.
속성 값의 목록에서 다음 값을 반환합니다.
속성 값을 문자열 형식으로 변환한 후 버퍼에 복사합니다.
인덱싱된 속성 값을 문자열로 변환한 후 버퍼에 복사합니다.
다음 함수는 원격 권한 부여 작업을 제어합니다.
원격 권한 부여 서버의 로그입니다.
사용자가 리소스에 액세스할 수 있는지 여부를 확인합니다.
lca_Init 함수는 LCA를 초기화합니다. 다른 LCA 함수를 사용하려면 먼저 lca_Init를 호출해야 합니다. 또한 이 함수는 szModuleName 매개 변수에 지정된 값과 호출 모듈을 식별하는 문자열을 사용하여 전역 변수를 할당합니다.
이 함수는 성공 시 0을 반환하고, 실패 시 0이 아닌 값을 반환합니다. 오류가 발생할 경우 ppOutput은 일반적으로 오류 메시지를 가리킵니다.
int lca_Init (const char *szModuleName, char **ppOutput);
이 API를 사용하는 모듈을 식별하는 문자열입니다.
참고: 이 매개 변수는 null 또는 빈 문자열일 수 없습니다.
오류 시 오류 메시지를 포함하는 문자열에 대한 포인터입니다.
lca_Terminate 함수는 LCA를 종료합니다. 이 함수는 열려 있는 파일 설명자를 닫고, 할당된 버퍼를 해제하고, lca_Init 함수가 설정한 모듈 이름을 다시 설정하고, 연결된 라이브러리를 동적으로 언로드합니다.
이 함수는 값을 반환하지 않습니다.
void lca_Terminate (void);
참고: lca_ParseLine 함수로 데이터베이스를 처리한 후에만 이 함수를 사용하십시오.
lca_ParseLine 함수는 szLine 매개 변수로 지정된 명령을 실행합니다. 명령을 실행한 후 lca_ParseLine 함수는 ppOutput 매개 변수가 CA ControlMinder에 의해 반환된 문자 문자열 버퍼를 가리키도록 설정합니다. 호출자는 메모리를 할당할 필요가 없습니다. 이 버퍼는 LCA에 의해 내부적으로 처리되며 사용자가 lca_Terminate 함수를 호출하면 해제됩니다.
이 함수는 다음 작업을 순서대로 수행합니다.
lca_ParseLine 함수는 상태를 구분합니다. 즉, 뒤에 나오는 명령의 동작을 변경합니다. 예를 들어 다음 시퀀스는 host a의 사용자 jan 속성을 나열합니다.
lca_ParseLine("hosts a", output);
lca_ParseLine("showusr jan", output);
명령을 실행하고 출력을 표시하는 단순한 응용 프로그램에는 lca_ParseLine을 제외한 함수가 필요하지 않을 수 있습니다. 보다 복잡한 응용 프로그램에는 더 많은 정보가 필요할 수 있으므로 다른 LCA 함수를 사용해야 할 수 있습니다.
이 함수는 성공 시 0을 반환하고, 오류 시 0이 아닌 값을 반환합니다.
int lca_ParseLine (char *szLine, char **ppOutput);
실행할 명령을 포함하는 null 종결 문자열입니다.
이 명령을 실행한 후 CA ControlMinder가 반환한 결과를 포함하는 null 종결 문자열에 대한 포인터입니다.
lca_ParseMBLine 함수는 다음을 제외하고 lca_ParseLine 함수와 동일한 방식으로 작동합니다.
이 추가 기능은 제품 현지화를 지원하며, 멀티바이트 형식 문자열을 입력할 수 있도록 합니다.
lca_CheckPasswordQuality 함수는 sepass 유틸리티(UNIX만 해당), selang 또는 정책 관리자를 통해 CA ControlMinder 데이터베이스나 네이티브 운영 체제에 있는 암호를 변경하지 않고 사용자의 새 암호를 검사합니다. CA ControlMinder 암호 규칙에 따라 암호를 검사할 수 있습니다. 암호는 규칙에 따라 허용되거나 거부됩니다.
암호가 허용 가능하면 이 함수는 0을 반환합니다. 암호가 거부될 경우에는 암호가 거부되었다는 결과를 반환하고 실패 기준이 되는 규칙을 제공합니다.
int lca_CheckPasswordQuality (char *szUNAME, char *szPassword, CHECK_RSULT **res, int domain);
암호 변경을 요청하는 사용자입니다.
사용자가 변경할 암호입니다.
액세스 요청의 결과에 대한 핸들을 지정합니다.
암호를 검사할 도메인을 지정합니다.
참고: 이 변수는 나중에 사용하기 위한 변수로, SEOS_DOMAIN에서만 구현됩니다.
lca_ErrsGetNum 함수는 CA ControlMinder가 lca_ParseLine 함수에 의해 전송된 마지막 명령을 실행한 후 반환한 오류, 경고 및 정보 메시지의 수를 반환합니다.
오류, 경고 또는 정보 메시지가 없으면 이 함수는 0을 반환합니다. 그렇지 않으면 이 함수는 반환된 오류, 경고 및 정보 메시지의 총 수를 반환합니다.
int lca_ErrsGetNum (void);
lca_ErrGetByIdx 함수는 인덱스가 idx인 오류에 대한 LCA_ERR_H 유형의 오류 핸들을 반환합니다. idx 매개 변수는 CA ControlMinder가 lca_ParseLine 함수에 의해 전송된 마지막 명령을 실행한 후 반환한 오류 및 메시지 목록 내에서의 인덱스입니다.
인덱스 범위는 0(첫 번째 오류의 경우)에서 n_errors‑1(마지막 오류의 경우) 사이입니다.
나중에 lca_ErrSeverity 및 lca_ErrStage 함수에 이 핸들을 함께 사용하여 오류 또는 메시지에 대한 정보를 추출할 수 있습니다.
이 함수는 성공 시 LCA_ERR_H 유형의 오류 핸들을 반환하고, 실패 시 NULL을 반환합니다.
LCA_ERR_H lca_ErrGetByIdx (int idx);
마지막 명령의 오류 목록에 있는 오류의 인덱스입니다.
lca_ErrGetFirst 함수는 lca_ParseLine 함수로 보낸 마지막 명령에서 발생한 첫 번째 오류에 대한 LCA_ERR_H 유형의 오류 핸들을 반환합니다.
나중에 lca_ErrSeverity 및 lca_ErrStage 함수에 이 핸들을 함께 사용하여 오류 또는 메시지에 대한 정보를 추출할 수 있습니다.
참고: 이 함수는 NULL 핸들을 사용하여 lca_ErrGetNext 함수를 호출할 때와 동일하게 작동합니다.
이 함수는 첫 번째 오류 레코드에 대해 LCA_ERR_H 유형의 오류 핸들을 반환하고 실패 시 NULL을 반환합니다.
LCA_ERR_H lca_ErrGetFirst (void);
lca_ErrGetNext 함수는 lca_ParseLine 함수에 보낸 마지막 명령에서 발생한 다음 오류에 대한 LCA_ERR_H 유형의 오류 핸들을 반환합니다.
나중에 lca_ErrSeverity 및 lca_ErrStage 함수에 이 핸들을 함께 사용하여 오류 또는 메시지에 대한 정보를 추출할 수 있습니다.
이 함수는 다음 오류 레코드에 대해 LCA_ERR_H 유형의 오류 핸들을 반환하고 실패 시 NULL을 반환합니다.
LCA_ERR_H lca_ErrGetNext (const LCA_ERR_H errhPrev);
이전에 반환된 오류의 핸들입니다. 값이 NULL이면 첫 번째 오류가 반환됩니다.
lca_ErrSeverity 함수는 오류 핸들 errh가 나타내는 오류의 심각도를 반환합니다. 가능한 심각도 값은 다음과 같습니다.
치명적 OS 내부 오류(예: 메모리 할당)가 발생했습니다.
명령 실행 시 오류가 발생했습니다.
명령이 성공적으로 실행되었지만 치명적이지 않은 오류가 발생했습니다.
오류가 발생하지 않았습니다. 오류 문자열에 정보 메시지나 경고가 포함되어 있습니다.
이 함수는 오류의 심각도를 반환하며, 실패 시 ‑1을 반환합니다.
int lca_ErrSeverity (const LCA_ERR_H errh);
오류 레코드의 핸들입니다.
lca_ErrStage 함수는 오류 핸들 errh가 나타내는 오류가 발생한 단계를 반환합니다. 가능한 단계 값은 다음과 같습니다.
데이터베이스를 업데이트하는 중 오류가 발생했습니다(예: 기존 개체 추가 또는 존재하지 않는 개체 삭제 시도).
권한 부여 프로세스로 인해 명령 실행되지 않았습니다. 예를 들어 사용자에게 명령을 실행할 수 있는 권한이 없습니다.
통신 중 오류가 발생했습니다. 이 문제는 대개 seagent 또는 seosd 데몬과의 통신에 실패했음을 나타냅니다.
원격 호스트에 대한 연결에 실패했습니다.
선행 범주에 속하지 않는 오류가 발생했습니다. 일반적으로 구문 오류나 명령 특성의 오류를 나타냅니다.
오류가 발생하지 않았습니다. 오류 문자열에 정보 메시지나 경고가 포함되어 있습니다.
이 함수는 오류의 단계를 반환하며, 실패 시 ‑1을 반환합니다.
int lca_ErrStage (const LCA_ERR_H errh);
오류 레코드의 핸들입니다.
lca_Err2Str 함수는 오류 레코드를 문자열로 변환하고 이 문자열을 szBuff에 복사합니다. 문자열이 iBuffLen보다 길면 lca_Err2Str 함수는 iBuffLen에 지정된 길이만큼 문자열을 자릅니다.
이 함수는 성공 시 출력되는 문자의 수를 반환하고, 실패 시 ‑1을 반환합니다.
int lca_Err2Str (const LCA_ERR_H errh, char *szBuff, int iBuffLen);
오류 레코드의 핸들입니다.
함수가 출력 문자열을 복사하는 대상 버퍼입니다.
szBuff의 크기입니다.
lca_QEntsGetNum 함수는 lca_ParseLine_r 함수로 보낸 마지막 명령으로 찾은 엔터티(개체)의 수를 반환합니다. 마지막 명령이 쿼리가 아닌 경우 lca_QEntsGetNum은 0을 반환합니다. 그렇지 않은 경우에는 찾은 엔터티 중 쿼리 조건과 일치하는 엔터티의 수를 반환합니다.
이 함수는 마지막 쿼리가 가져온 엔터티(개체)의 수를 반환합니다. 오류가 발생하면 이 함수는 ‑1을 반환합니다.
int lca_QEntsGetNum (void);
lca_QEntGetByIdx 함수는 인덱스가 idx인 엔터티의 엔터티 핸들을 반환합니다. idx 매개 변수는 lca_ParseLine 함수로 보낸 마지막 명령의 엔터티 목록에 있는 엔터티의 인덱스입니다.
인덱스 범위는 0(첫 번째 엔터티의 경우)에서 n_entities‑1(마지막 엔터티의 경우) 사이입니다. 예를 들어 쿼리가 세 개의 엔터티를 반환한 경우 idx 값은 0, 1 또는 2일 수 있습니다. 나중에 이 핸들을 사용하여 엔터티에 대한 정보를 추출할 수 있습니다.
showusr jan과 같이 단일 개체에 대한 쿼리인 경우 이 함수는 idx가 0일 때만 엔터티 핸들을 반환하고, 그렇지 않으면 NULL을 반환합니다. showusr jan*와 같이 여러 개체에 대한 쿼리인 경우 이 함수는 idx 매개 변수로 지정된 엔터티 핸들을 반환합니다.
이 함수는 LCA_QENT_H 유형의 엔터티 핸들을 반환하며, 실패 시 NULL을 반환합니다.
LCA_QENT_H lca_QEntGetByIdx (int idx);
마지막 쿼리 명령이 반환한 엔터티(개체) 목록에 있는 엔터티의 인덱스입니다.
lca_QEntGetFirst 함수는 lca_ParseLine 함수로 보낸 마지막 명령이 반환한 엔터티 목록에 있는 첫 번째 엔터티에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
특성이 NULL인 lca_QEntGetNext 함수를 호출하는 경우에도 동일한 결과가 나타납니다.
나중에 이 핸들을 사용하여 엔터티에 대한 정보를 추출할 수 있습니다.
이 함수는 쿼리가 반환한 엔터티 수에 상관없이 첫 번째 엔터티 핸들만 반환합니다. 후속 엔터티 핸들을 순차적으로 반환하려면 lca_QEntGetNext 함수를 사용하고, 특정 엔터티 핸들을 반환하려면 lca_QEntGetByIdx 함수를 사용하십시오.
이 함수는 성공 시 LCA_QENT_H 유형의 엔터티 핸들을 반환하고, 실패 시 NULL을 반환합니다.
LCA_QENT_H lca_QEntGetFirst (void);
lca_QEntGetNext 함수는 lca_ParseLine 함수로 보낸 마지막 명령의 엔터티 목록에 있는 다음 엔터티에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
qenthPrev 매개 변수가 NULL이면 이 함수는 목록에 있는 첫 번째 엔터티를 반환합니다. 나중에 이 핸들을 사용하여 엔터티에 대한 정보를 추출할 수 있습니다.
이 함수는 성공 시 LCA_QENT_H 유형의 엔터티 핸들을 반환하고, 실패 시 NULL을 반환합니다.
LCA_QENT_H lca_QEntGetNext (const LCA_QENT_H qenthPrev);
쿼리의 엔터티 목록에 있는 이전 엔터티의 핸들입니다.
lca_QEntGetByName 함수는 lca_ParseLine 함수로 보낸 마지막 명령의 엔터티 목록에 있는 하나의 엔터티에 대한 LCA_QENT_H 유형의 엔터티 핸들을 반환합니다.
이 함수는 엔터티 목록에서 클래스 이름이 szCName과 동일하고 개체 이름이 szOName과 동일한 엔터티를 검색합니다. szCName이 비어 있는 경우 이 함수는 일치하는 개체 이름만 검색합니다. 이 함수는 일치하는 엔터티에 대한 엔터티 핸들을 반환합니다. 나중에 반환된 핸들을 사용하여 엔터티에 대한 정보를 추출할 수 있습니다.
이 함수는 성공 시 LCA_QENT_H 유형의 엔터티 핸들을 반환하고, 실패 시 NULL을 반환합니다.
LCA_QENT_H lca_QEntGetByName (const char *szCName, const char *szOName);
엔터티의 클래스 이름이 포함된 문자열입니다.
엔터티의 개체 이름이 포함된 문자열입니다.
lca_QEntObjName 함수는 엔터티 핸들 qenth가 가리키는 개체의 이름을 반환합니다. 쿼리의 결과에 개체 이름이 없으면 개체 이름의 반환 값도 비어 있습니다(NULL). 예를 들어 데이터베이스의 클래스를 모두 나열하는 찾기 명령을 실행한 후 쿼리의 결과가 개체 이름이 아니라 클래스 이름이므로 반환된 문자열이 비어 있습니다. 이 경우 lca_QEntClassName 함수를 사용하십시오.
이 함수는 개체 이름이 포함된 문자열에 대한 포인터를 반환하거나, 개체 이름이 비어 있는 경우 NULL을 반환합니다.
char *lca_QEntObjName (const LCA_QENT_H qenth);
엔터티 핸들입니다.
lca_QEntClassName 함수는 핸들 qenth가 가리키는 엔터티의 클래스 이름을 반환합니다. 쿼리의 결과에 클래스 이름이 없으면 클래스 이름의 반환 값도 비어 있습니다(NULL). 예를 들어 find classname 명령은 지정된 클래스의 개체 이름만 반환합니다.
이 함수는 성공 시 클래스 이름을 포함하는 문자열에 대한 포인터를 반환하고, 실패 시 NULL을 반환합니다.
char *lca_QEntClassName (const LCA_QENT_H qenth);
엔터티 핸들입니다.
lca_QPropsGetNum 함수는 핸들 qenth가 가리키는 엔터티에 대해 쿼리된 속성의 수를 반환합니다. lca_ParseLine 함수가 실행한 마지막 명령으로 엔터티를 받은 것으로 가정합니다.
개체에 대해 사용 가능한 속성의 수는 쿼리에 따라 달라집니다. 예외: 쿼리가 find 명령인 경우에는 개체 또는 클래스 이름만 반환되므로 속성을 사용할 수 없습니다.
쿼리가 showusr, showgrp 또는 showres 명령인 경우 이 함수는 qenth가 가리키는 엔터티에 대해 설정되고 표시할 수 있는 모든 속성 수를 계산합니다.
참고: 이 함수가 반환하는 속성의 수는 해당 엔터티에 대한 데이터베이스에 있는 속성의 총 수와 반드시 같지 않아도 됩니다. 대신 반환된 숫자는 엔터티에 대한 마지막 쿼리의 결과를 나타냅니다. 엔터티 핸들은 쿼리에서 엔터티의 데이터를 가리키는 핸들로, 이 API를 사용하여 쿼리 데이터에 액세스하는 경우에만 사용됩니다.
이 함수는 성공 시 엔터티에 사용 가능한 속성의 수를 반환하고, 실패 시 ‑1을 반환합니다.
int lca_QPropsGetNum (const LCA_QENT_H qenth);
엔터티 핸들입니다.
lca_QPropGetByIdx 함수는 해당 인덱스 idx가 이 엔터티의 속성 목록에 있는 속성에 대한 속성 핸들을 반환합니다. 인덱스 범위는 0(첫 번째 속성의 경우)에서 n_props‑1(마지막 속성의 경우) 사이입니다.
나중에 반환된 핸들을 사용하여 lca_QPropVal2StrEx, lca_QPropValGetFirst, lca_QPropValGetNext 및 lca_QPropValList 함수를 사용할 때 속성에 대한 데이터를 추출할 수 있습니다.
이 함수는 요청된 속성에 대한 속성 핸들을 반환합니다. 이 엔터티에 대해 지정된 인덱스를 갖는 속성이 없는 경우 이 함수는 NULL을 반환합니다.
LCA_QPROP_H lca_QPropGetByIdx (const LCA_QENT_H qenth, int idx);
쿼리의 엔터티를 식별하는 엔터티 핸들입니다.
엔터티의 속성 목록에 있는 요청된 속성의 인덱스입니다.
lca_QPropGetFirst 함수는 qenth 매개 변수가 가리키는 엔터티의 첫 번째 속성에 대한 속성 핸들을 반환합니다. 나중에 반환된 핸들을 사용하여 lca_QPropVal2StrEx, lca_QPropValGetFirst, lca_QPropValGetNext 및 lca_QPropValList 함수를 사용할 때 속성에 대한 데이터를 추출할 수 있습니다.
이 함수는 속성 핸들을 반환합니다. 이 엔터티의 쿼리 결과에서 사용 가능한 속성이 없으면 이 함수는 NULL을 반환합니다.
LCA_QPROP_H lca_QPropGetFirst (const LCA_QENT_H qenth);
쿼리의 엔터티를 식별하는 엔터티 핸들입니다.
lca_QPropGetNext 함수는 qenth 매개 변수가 가리키는 엔터티에 대해 qprophPrev 매개 변수에 지정된 속성 다음에 있는 속성의 속성 핸들을 반환합니다. qprophPrev 함수가 NULL인 경우에는 목록에 있는 첫 번째 속성을 반환합니다.
나중에 반환된 핸들을 사용하여 lca_QPropVal2StrEx, lca_QPropValGetFirst, lca_QPropValGetNext 및 lca_QPropValList 함수를 사용할 때 속성에 대한 데이터를 추출할 수 있습니다.
이 함수는 속성 핸들을 반환합니다. 이 엔터티의 쿼리 결과에서 사용 가능한 속성이 더 이상 없으면 이 함수는 NULL을 반환합니다.
LCA_QPROP_H lca_QPropGetNext (const LCA_QENT_H qenth, \ const LCA_QPROP_H qprophPrev);
쿼리의 엔터티를 식별하는 엔터티 핸들입니다.
마지막으로 검색된 속성의 속성 핸들입니다.
lca_QPropGetByName 함수는 이름이 qenth 매개 변수가 가리키는 엔터티의 szPName 매개 변수에 있는 대상 속성의 속성 핸들을 반환합니다. 나중에 반환된 핸들을 사용하여 lca_QPropVal2StrEx, lca_QPropValGetFirst, lca_QPropValGetNext 및 lca_QPropValList 함수를 사용할 때 속성에 대한 데이터를 추출할 수 있습니다.
이 함수는 속성 핸들을 반환합니다. 이 이름을 가진 속성이 없으면 이 함수는 NULL을 반환합니다.
LCA_QPROP_H lca_QPropGetByName (const LCA_QENT_H qenth const char szPName);
쿼리의 엔터티를 식별하는 엔터티 핸들입니다.
속성 이름을 나타내는 문자열입니다.
lca_QPropName 함수는 엔터티의 속성 하나를 식별하는 속성 핸들을 받아 해당 속성의 이름을 반환합니다. 이 함수는 단일 속성에 대한 정보를 검색하는 함수의 그룹에 속해 있습니다. 속성 이름은 데이터베이스에 정의된 이름이나 UNIX 쿼리의 경우 CA ControlMinder가 UNIX 속성에 지정한 심볼 이름입니다.
이 함수는 성공 시 속성 이름을 나타내는 문자열을 반환하고, 실패 시 NULL을 반환합니다.
char *lca_QPropName (const LCA_QPROP_H qproph);
속성 핸들입니다.
lca_QPropSize 함수는 엔터티의 속성 하나를 식별하는 속성 핸들을 받아 해당 속성의 크기(바이트)를 반환합니다. 이 함수는 단일 속성에 대한 정보를 검색하는 함수의 그룹에 속해 있습니다. 크기는 속성의 단일 값에 대해 반환됩니다. ACL(액세스 제어 목록)과 같은 목록 속성인 경우 단일 요소의 크기가 반환됩니다. 전체 목록의 크기를 확인하려면 단일 값의 크기에 목록에 있는 값의 수를 곱하십시오. lca_QPropValsNum 함수를 사용하여 목록에 있는 값의 수를 검색할 수 있습니다.
이 함수는 성공 시 속성의 크기를 반환하고, 실패 시 ‑1을 반환합니다.
unsigned short lca_QPropSize (const LCA_QPROP_H qproph);
속성 핸들입니다.
lca_QPropType 함수는 엔터티의 속성 하나를 식별하는 속성 핸들을 받아 해당 속성의 유형을 반환합니다. 이 함수는 단일 속성에 대한 정보를 검색하는 함수의 그룹에 속해 있습니다. 가능한 속성 유형은 seostype.h 헤더 파일에 나열되어 있습니다.
이 함수는 성공 시 속성 유형을 나타내는 단일 문자를 반환하고, 실패 시 ‑1을 반환합니다.
char lca_QPropType (const LCA_QPROP_H qproph);
속성 핸들입니다.
lca_QPropValsNum 함수는 엔터티의 속성 하나를 식별하는 속성 핸들을 받아 해당 속성의 값 수를 반환합니다. 이 함수는 단일 속성에 대한 정보를 검색하는 함수의 그룹에 속해 있습니다. 대부분 속성에서 숫자는 항상 한 개입니다. 그러나 두 개의 이상의 값이 있을 수 있는 목록으로 구성된 속성도 있습니다. 목록으로 구성된 속성의 예로는 ACL, PACL, INetACL, UserList 및 GroupList가 있습니다.
이 함수는 성공 시 속성의 값 수를 반환합니다. 이 함수가 실패할 경우에는 ‑1을 반환합니다.
unsigned int lca_QPropValsNum (const LCA_QPROP_H qproph);
속성 핸들입니다.
lca_QPropValList 함수는 qproph 매개 변수로 식별되는 단일 속성에 대한 속성 값을 반환합니다. 반환되는 값은 값에 대한 포인터 배열입니다. 속성 값이 단일 값인 경우에는 첫 번째 포인터만 유효합니다. 목록에서 유효한 포인터 수를 확인하려면 lca_QPropValsNum 함수를 호출하십시오.
이 함수는 성공 시 속성 값에 포인터의 배열에 대한 포인터를 반환하고, 실패 시 NULL을 반환합니다.
void **lca_QPropValList (const LCA_QPROP_H qproph);
속성 핸들입니다.
lca_QPropGetByIdx_r 함수는 엔터티의 속성 하나를 식별하는 속성 핸들을 받아 속성 값을 반환합니다. idx 매개 변수는 이 함수가 값을 반환할 해당 속성을 식별합니다.
이 함수는 속성의 값 목록에 있는 인덱스로 값을 식별합니다. 인덱스 범위는 0부터 lca_QPropValsNum 함수가 반환한 값에서 1을 뺀 값까지입니다.
목록에 있는 값의 수를 확인하려면 lca_QPropValsNum을 호출하십시오. 필욘 경우 lca_QPropVal2StrEx 함수를 사용하여 이 값을 문자열로 변환하십시오.
이 함수는 성공 시 단일 속성 값에 대한 포인터를 반환하고, 실패 시 NULL을 반환합니다.
void *lca_QPropValGetByIdx (const LCA_QPROP_H qproph, int idx);
속성 핸들입니다.
속성의 값에 대한 인덱스입니다(목록 속성의 경우).
lca_QPropValGetFirst 함수는 qproph 매개 변수로 식별된 속성의 값 목록에 있는 첫 번째 값을 반환합니다. 필욘 경우 lca_QPropVal2StrEx 함수를 사용하여 값을 문자열로 변환하십시오.
이 함수는 성공 시 단일 속성 값에 대한 포인터를 반환하고, 실패 시 NULL을 반환합니다.
void *lca_QPropValGetFirst (const LCA_QPROP_H qproph);
속성 핸들입니다.
lca_QPropValGetNext 함수는 qproph 매개 변수로 식별된 속성의 값 목록에 있는 다음 속성 값을 반환합니다. pPrevVal 매개 변수는 목록에서 이전 값을 식별합니다. 이 함수는 pPrevVal 다음의 값을 반환합니다. pPrevVal이 NULL이면 이 함수는 목록에서 첫 번째 값을 반환합니다.
나중에 lca_QPropVal2StrEx 함수를 사용하여 반환된 값을 문자열로 변환하라 수 있습니다.
이 함수는 성공 시 단일 속성 값에 대한 포인터를 반환하고, 실패 시 NULL을 반환합니다.
void *lca_QPropValGetNext (const LCA_QPROP_H qproph, const void *pPrevVal);
속성 핸들입니다.
목록에서 이전 값입니다.
lca_QPropVal2Str 함수는 속성 값을 문자열로 변환하고 이 문자열을 szBuff에 복사합니다. 문자열이 iBuffLen보다 길면 lca_QPropVal2Str 함수는 iBuffLen에 지정된 길이만큼 문자열을 자릅니다.
중요! 이 함수는 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 사용할 수 있습니다. 대신 lca_QPropVal2StrEx 함수를 사용해야 합니다.
이 함수는 성공 시 출력되는 문자의 수를 반환하고, 실패 시 ‑1을 반환합니다.
int lca_QPropVal2Str (const LCA_QPROP_H qproph, \ const void *pVal, char *szBuff, int iBuffLen);
속성 핸들입니다.
변환할 속성 값에 대한 포인터입니다.
함수가 출력 문자열을 복사하는 대상 버퍼입니다.
szBuff의 크기입니다.
lca_rmtauth_Init 함수는 szHost 매개 변수로 지정된 원격 권한 부여 서버에 대한 로그인을 시도합니다. 이 함수는 서버에 대한 연결을 설정하여 szPasswd 매개 변수가 전달한 암호가 응용 프로그램을 실행하는 사용자의 암호화 일치하는지 여부를 확인합니다. 암호가 일치하는 경우 로그인 프로세스가 계속됩니다.
이 함수는 로그인 성공 시 0을 반환하고, 실패 시 0이 아닌 값을 반환합니다. 로그인에 실패할 경우 ppOutput 매개 변수는 오류 메시지를 가리킵니다.
int lca_rmtauth_Init (const char *szModuleName, \ char **ppOutput, char *szHost, char *szPasswd);
응용 프로그램의 이름입니다.
참고: 이 매개 변수는 null 또는 빈 문자열일 수 없습니다.
오류 시 오류 메시지 문자열에 대한 포인터입니다.
연결할 서버의 이름입니다.
서버에 액세스하는 사용자의 암호입니다.
lca_rmtauth_CheckAccess 함수는 CA ControlMinder 원격 권한 부여 서버에 쿼리하여 szAccessor로 지정된 사용자가 지정된 액세스 유형(szAccs)을 사용할 때 지정된 리소스(szOName)에 액세스할 수 있는지 여부를 확인합니다. 이 함수가 원격 권한 부여 서버로 요청을 보내면 해당 서버는 SEOSROUTE_RequestAuth 함수를 사용하여 검사를 수행합니다.
이 함수는 로그인 성공 시 0을 반환하고, 실패 시 0이 아닌 값을 반환합니다.
int lca_rmtauth_CheckAccess (const char *szAccessor, \ char *szClass, char *szOName, char *szAccs, API_AUTH_RES *result);
권한 부여를 요청하는 접근자(사용자)의 이름입니다.
액세스 권한을 확인할 리소스입니다.
사용자가 액세스를 요청 중인 리소스 개체입니다.
요청된 액세스의 유형입니다. 유효한 액세스 유형은 seostype.h 헤더 파일에 나열되어 있습니다.
액세스 요청에 대한 서버의 결과입니다.
|
Copyright © 2013 CA.
All rights reserved.
|
|