SuplCertificateInterface संरचना संदर्भ
#include < gps.h >
डेटा फ़ील्ड | |
| आकार_t | आकार |
| पूर्णांक(* | install_certificates )(const DerEncodedCertificate *प्रमाणपत्र, size_t लंबाई) |
| पूर्णांक(* | revoke_certificates )(const Sha1CertificateFingerprint *फिंगरप्रिंट, size_t लंबाई) |
विस्तृत विवरण
फ़ील्ड दस्तावेज़ीकरण
| int(* install_certificates)(const DerEncodedCertificate *प्रमाणपत्र, size_t लंबाई) |
एजीपीएस सर्वर से एसयूपीएल कनेक्शन के लिए उपयोग किए जाने वाले प्रमाणपत्रों का एक सेट स्थापित करता है। यदि आवश्यक हो तो एचएएल को आंतरिक रूप से किसी भी प्रमाणपत्र का पता लगाना चाहिए जिसे स्थापित करने के लिए प्रमाणपत्रों को समायोजित करने के लिए हटाने की आवश्यकता है। स्थापित प्रमाणपत्र एजीपीएस एसयूपीएल सर्वर से कनेक्ट करने के लिए आवश्यक वैध प्रमाणपत्रों के एक पूरे सेट का प्रतिनिधित्व करते हैं। प्रमाणपत्रों की सूची आवश्यक है, और एजीपीएस सर्वर के साथ कनेक्शन स्थापित करने का प्रयास करते समय सभी प्रमाणपत्र एक ही समय में उपलब्ध होने चाहिए।
पैरामीटर्स: प्रमाणपत्र - डीईआर एन्कोडेड प्रमाणपत्रों की एक श्रृंखला के लिए एक सूचक जिन्हें एचएएल में स्थापित करने की आवश्यकता है। लंबाई - स्थापित करने के लिए प्रमाणपत्रों की संख्या। रिटर्न: AGPS_CERTIFICATE_OPERATION_SUCCESS यदि ऑपरेशन सफलतापूर्वक पूरा हो गया है AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES यदि HAL स्थापित करने का प्रयास किए गए प्रमाणपत्रों की संख्या संग्रहीत नहीं कर सकता है, तो संग्रहीत प्रमाणपत्रों की स्थिति इस त्रुटि मामले में पहले की तरह ही रहनी चाहिए।
महत्वपूर्ण: यदि आवश्यक हो तो एचएएल को आंतरिक रूप से प्रमाणपत्रों के सेट का पता लगाना चाहिए जिन्हें स्थापित करने के लिए प्रमाणपत्रों को समायोजित करने के लिए हटाने की आवश्यकता है।
| int(* revoke_certificates)(const Sha1Certificateफिंगरप्रिंट *फिंगरप्रिंट, size_t लंबाई) |
एचएएल को सूचित करता है कि एसयूपीएल कनेक्शन के लिए उपयोग किए गए प्रमाणपत्रों की सूची रद्द कर दी गई है। यह उम्मीद की जाती है कि प्रमाणपत्रों का दिया गया सेट एचएएल के आंतरिक स्टोर से हटा दिया गया है।
पैरामीटर: फ़िंगरप्रिंट - निरस्त किए जाने वाले प्रमाणपत्रों के सेट की पहचान करने के लिए SHA1 फ़िंगरप्रिंट की एक सरणी के लिए एक संकेतक। लंबाई - प्रदान किए गए उंगलियों के निशान की संख्या। रिटर्न: यदि ऑपरेशन सफलतापूर्वक पूरा हो जाता है तो AGPS_CERTIFICATE_OPERATION_SUCCESS।
महत्वपूर्ण: यदि प्रदान किए गए प्रमाणपत्रों में से कोई भी (इसके फिंगरप्रिंट के माध्यम से) एचएएल द्वारा ज्ञात नहीं है, तो इसे नजरअंदाज कर दिया जाना चाहिए और बाकी को रद्द/हटाना जारी रखना चाहिए।
इस संरचना के लिए दस्तावेज़ीकरण निम्नलिखित फ़ाइल से तैयार किया गया था:
- हार्डवेयर/लिबहार्डवेयर/शामिल/हार्डवेयर/ जीपीएस.एच